Docs
Basics
API Reference
Basics
API Reference
  1. Pay with Woldy
  • Introduction
  • Merchant Dashboard
    • Get Started
    • What is Branches
    • What is Vault and how Settlement works
  • Pay with Woldy
    • How to Pay with Woldy
    • How to Subscribe with Woldy
  1. Pay with Woldy

How to Pay with Woldy

Woldy lets customers pay with stablecoins through a hosted checkout flow. No account is required — just a compatible wallet and enough stablecoin balance.
The payment page opens on gateway.woldy.xyz, where the customer connects a wallet, reviews the payment, and confirms the transaction.

What you'll need#

A wallet that supports WalletConnect
USDT or USDC
Funds on one of the supported networks: Ethereum, Polygon, Arbitrum, Optimism, or Base
🫂
Woldy covers network gas fees at checkout.
Customers do not need to hold native gas tokens to complete the payment.

How to pay#

1
Open the payment page
The merchant shares a payment link or redirects the customer to Woldy checkout on gateway.woldy.xyz
2
Connect a wallet
The customer taps Connect Wallet and chooses a wallet through WalletConnect
3
Review payment details
Before confirming, the customer checks: amount, token, network and recipient
4
Confirm the payment
The wallet shows the transaction details.
The customer approves the payment in the wallet
5
Wait for confirmation
Once the transaction is confirmed onchain, the payment is completed and the checkout page updates automatically
ℹ
Paying with USDT?
The first time you use USDT on a given network, your wallet will ask you to approve Permit2 before you can pay — a one-time, per-network setup. You pay the small network gas fee for this approval only; every USDT payment after that is gasless. USDC never requires this step. Learn more about Permit2 ↓

Supported wallets#

Woldy works with wallets that support WalletConnect, including:
MetaMask MetaMask
Rainbow Rainbow
Trust Wallet Trust Wallet
Coinbase Wallet Coinbase Wallet
Zerion Zerion
1inch Wallet 1inch Wallet
Uniswap Wallet Uniswap Wallet
and many more

What is Permit2?#

Permit2 is a smart contract built by Uniswap. It exists to solve a specific problem: most tokens, including USDT, don't natively support gasless approvals — every spending permission normally requires its own on-chain transaction, paid in gas.
Permit2 fixes this by acting as a middle layer. You grant a Permit2 approval once; after that, Permit2 can issue scoped, gasless payment signatures to other contracts (like Woldy's payment contract) on your behalf, without you paying gas again. That's what makes every USDT payment after the first one free of gas fees for you.
Woldy uses Permit2 only for USDT. USDC supports gasless transfers natively, so it never needs this step.

The Permit2 approval vs. each payment signature — and why it's safe#

There are two separate actions involved, and it's worth knowing the difference:
The Permit2 approval is the one-time action you take per network. It tells the blockchain that the Permit2 contract is allowed to process gasless transfers of your USDT — nothing more.
Each payment signature is what authorizes one specific transfer, for one specific amount, to one specific payment. You sign this every time you pay. It is not a standing permission — it does nothing on its own without the Permit2 approval already in place, and it doesn't grant any future access.
This split is what keeps it safe:
Scoped, not unlimited custody. The Permit2 approval lets the Permit2 contract relay transfers — it doesn't give Woldy, or anyone else, standing access to your wallet.
It expires automatically. Permit2 approvals carry an expiration time, so old permissions age out on their own instead of sitting active indefinitely.
Nothing moves without your signature. The approval alone moves no funds. Every payment still requires you to separately sign that specific transaction.
You can revoke the approval anytime. Tools like revoke.cash let you check and cancel your Permit2 approval, independent of Woldy, at any time.
One thing worth knowing: because Permit2 is flexible enough to bundle approvals for several tokens into a single request, it's a pattern that phishing sites have tried to abuse — always check exactly what you're approving in your wallet before confirming, and don't approve anything from a payment page you don't trust.

Security#

Woldy never asks for a seed phrase or private key.
If any page or app asks for it, the customer should not proceed.
Customers always review the transaction in their own wallet before approving it.

Common questions#

Do I need native gas tokens to pay?
No. Woldy covers network gas fees at checkout.
Can I pay with ETH?
What happens if the payment is still pending?
What if the payment page expires?
Do I need a Woldy account to pay?
Why do I need to approve something before paying with USDT?
Why do I have to pay gas for the USDT approval if Woldy covers gas?
Is the Permit2 approval safe? Does it give Woldy access to my funds?
Modified at 2026-06-22 05:22:31
Previous
What is Vault and how Settlement works
Next
How to Subscribe with Woldy
Built with