How to Subscribe with Woldy

Woldy lets you set up a recurring stablecoin subscription through a hosted checkout flow. No account is required — just a compatible wallet and enough token balance for the first charge.

The subscription page opens on gateway.woldy.xyz, where you connect a wallet, review the plan, and authorize recurring payments.

Authorizing a subscription always involves two steps under the hood: a one-time Permit2 approval for your token (if you haven't granted it before on this network), and then your Allowance signature — the actual authorization that sets the plan's cap and expiration. For USDC, the Permit2 approval itself is a free signature. For USDT, it's a small on-chain transaction you pay gas for, once per network — see the note below.

What you'll need

A wallet that supports WalletConnect

USDC or USDT

Funds on one of the supported networks: Ethereum, Polygon, Arbitrum, Optimism, or Base

🫂

Woldy covers network gas fees for subscribing and for every recurring charge.
You do not need to hold native gas tokens to subscribe or to keep paying.

Open the subscription page

The merchant shares a subscription link or redirects you to Woldy checkout on gateway.woldy.xyz

Connect a wallet

Tap Connect Wallet and choose a wallet through WalletConnect

Review the plan

Before authorizing, check: amount per period, billing period, how long the subscription runs, and the maximum total amount (cap) Woldy can charge over that time

Authorize the subscription

If this is your first time using this token on this network, your wallet will first ask for a one-time Permit2 approval — see the note below. After that (or immediately, if you've already granted it), your wallet shows your Allowance signature: this sets the plan's cap and expiration. Approving it authorizes Woldy to charge your plan's amount each period, up to the cap, until the subscription ends or you cancel

Wait for confirmation

Once your authorization is confirmed onchain, your subscription becomes active and the checkout page updates automatically

ℹ

First time on this network? Before you can authorize a subscription, your wallet will ask you to approve Permit2 — a smart contract built by Uniswap — for your token. This is a one-time, per-network setup. For USDC, this approval is itself a free signature, not a transaction. For USDT, it's a small onchain transaction and you pay the network gas fee for it, once per network. Either way, every charge after that — including this subscription and any future one on the same network — is gasless. Learn more about Permit2 ↓

What you're actually authorizing

Subscribing does not give the merchant a blank check. The signature you approve sets two hard limits, enforced onchain:

A cap — the maximum total amount Woldy can ever charge across the lifetime of this subscription

An expiration date — after which the authorization stops working entirely, whether or not the cap was reached

Within those limits, charges are billed once per period for the plan's amount. You'll see this expressed on checkout as "up to [amount] per period, up to [cap] total by [date] — cancel anytime."

Why we ask for your email

You'll be asked for an email address as part of authorizing your subscription. It's used to send you subscription receipts, renewal reminders, and — importantly — instructions for how to cancel or manage your subscription directly from your own wallet, independent of the merchant. Since Woldy subscriptions don't require an account, your email is the way we can reach you if anything needs your attention.

Changing your plan

If you want to move to a different plan — upgrade to a bigger one, downgrade to a smaller one, or switch your billing period — you'll receive a checkout link to confirm the change. Because each plan is backed by its own onchain contract, switching always means authorizing the new plan with a fresh signature; it can't happen silently in the background.

How to switch plans

Open the change link

You'll receive a checkout link for the new plan, similar to your original subscription link

Review the change

The page shows what's changing: the new plan's price and period, when it takes effect, any prorated amount due now (for upgrades), and the new authorization limit (cap)

Connect the wallet and sign

Connect your wallet and approve the new plan's authorization — one signature. If it's an upgrade, the prorated charge is taken through that same authorization, with no separate signature

Done

For an upgrade, the switch is immediate. For a downgrade or period change, your current plan keeps running until the end of the period, then the new one takes over

What happens for each kind of change

Upgrading (to a more expensive plan) takes effect immediately. You pay a prorated top-up for the time left in your current period — for example, if you're halfway through a 10 USD/month plan and move to a 20 USD/month plan, you're charged roughly the difference for the remaining days. You sign once to authorize the new plan; the prorated charge happens through that authorization, so there's no separate signature for it. Your old plan is then cancelled and the new one becomes active right away.

Downgrading (to a cheaper plan) takes effect at the end of your current period. You keep what you're already paying for until the period ends — there's no refund for the difference — and the new, cheaper plan starts after that. You sign once to authorize the new plan.

Switching billing period (for example monthly to annual) always takes effect at the end of your current period, the same way a downgrade does, regardless of price.

A few things worth knowing:

You'll only ever sign — never pay gas. Every change is authorized with signatures, and Woldy covers the gas for submitting them.

Nothing is charged until you confirm. If you don't sign the change before the link expires, nothing happens — your current subscription simply continues unchanged.

Changing from a free trial is only possible as an upgrade. Your trial ends immediately and the new plan's first full charge happens right away.

Paying from a different wallet, token, or network

Because your authorization is tied to the specific wallet, token, and network you signed with, switching any of those means signing a new authorization:

A different wallet — sign the new plan's authorization from whichever wallet you'd like to pay with. Your subscription simply points to the new authorization. The wallet you pay from doesn't have to be the same one you used before.

A different token or network — moving to a plan priced in another token (say USDC instead of USDT), or on another network, works the same way: you authorize the new plan on that token/network with a fresh signature. The new authorization replaces the old one as your active payment source.

In every case the rule is the same: a new wallet, token, or network is just a new signature on the new plan — Woldy covers the gas for submitting it, and nothing moves until you confirm.

Cancelling your subscription

A subscription can be cancelled at any time. Cancelling stops all future charges — and, depending on how the cancellation is set up, either ends the subscription immediately or lets it run until the end of the period you've already paid for.

There are two layers worth understanding, because of how self-custody works:

1. Stopping the charges. When a subscription is cancelled, Woldy stops requesting any further payments against your authorization. No more charges are made.

2. Revoking the authorization from your own wallet. Cancelling stops Woldy from charging, but your onchain authorization technically remains valid until its expiration date — Woldy can't reach into your wallet to remove it for you. If you want a hard, onchain guarantee that nothing can ever be charged again, you can revoke the authorization yourself:

With a revoke signature — where offered, Woldy can present a one-tap revoke you sign in your wallet (gasless — Woldy covers the gas). This sets the authorization to zero onchain.

With a third-party tool — revoke.cash lets you view and cancel any token authorization on your wallet, completely independent of Woldy, at any time.

This is the core of Woldy's self-custody model: stopping the billing is Woldy keeping its word, but revoking the authorization is your power, exercised directly from your wallet — no one else can do it, and no one can stop you from doing it.

If a payment can't go through

Recurring charges can occasionally fail. What happens next depends on why it failed — and in most cases your subscription isn't cancelled right away.

Not enough balance in your wallet. Your subscription moves to a "past due" state and Woldy retries the charge a few times over the following days. Top up your wallet during this window and the next retry goes through, returning your subscription to active — your billing date doesn't shift. If the retries are exhausted without enough balance, the subscription is cancelled.

Your authorization limit (cap) is used up. If your subscription's total cap has been reached, retries won't help on their own — you'll be asked to authorize a top-up by signing a new allowance (the same kind of signature as the original checkout, gasless where your token supports it). Once you sign, the charge is attempted immediately. If you don't top up within the grace window, the subscription is cancelled.

Your authorization has expired. Every subscription authorization has an expiration date. Once it passes, no further charges are possible and the subscription ends — there's nothing to retry. Woldy reminds you ahead of time so you can renew before this happens, by signing a fresh authorization that extends the date.

In all of these cases, Woldy notifies you (by email) before your subscription is affected, so you have a chance to act.

Supported wallets

Woldy works with wallets that support WalletConnect, including:

MetaMask · Rainbow · Trust Wallet · Coinbase Wallet · Zerion · 1inch Wallet · Argent · Uniswap Wallet · and many more

Security

Woldy never asks for a seed phrase or private key.
If any page or app asks for it, you should not proceed.

You always review the authorization in your own wallet before approving it — including the amount, the cap, and the expiration date.

What is Permit2?

Permit2 is a smart contract built by Uniswap. Woldy subscriptions use it as the underlying allowance mechanism for every token — it's what lets a plan's contract request your recurring charge each period, within the cap and expiration you authorized, without asking for a new signature every time.

Before you can grant that authorization, your wallet needs to approve the Permit2 contract itself for your token — a one-time, per-network setup. How that approval works depends on the token:

USDC supports a gasless approval format (EIP-2612), so approving Permit2 for USDC is just a free signature — not a transaction.

USDT doesn't support that format, so approving Permit2 for USDT is a small onchain transaction, and you pay the network gas fee for it once per network.

Either way, you only see this once per token per network. Every subscription authorization and every recurring charge after that is gasless, regardless of token.

The Permit2 approval vs. your subscription authorization — 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 token per network. It tells the blockchain that the Permit2 contract is allowed to process gasless transfers of that token — nothing more.

Your subscription authorization is the signature that sets the cap and expiration for this specific plan. It is not a standing permission to move funds on its own — it only allows charges that the plan's contract is allowed to request, within the limits you approved.

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.

Hard limits, enforced onchain. Your subscription authorization carries its own cap and expiration. No charge can exceed the cap or land after the expiration date, regardless of what the merchant requests.

Nothing moves without your signature. The Permit2 approval alone moves no funds. It only becomes useful once you separately authorize a specific plan.

You can revoke the Permit2 approval anytime. Tools like revoke.cash let you check and cancel it, 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 checkout page you don't trust.

Common questions

Do I need native gas tokens to subscribe?

No. Woldy covers gas for subscribing and for every recurring charge.

Can I subscribe with ETH?

Why do I need to approve something before authorizing a subscription?

Why do I have to pay gas for the USDT approval if Woldy covers gas?

Is the subscription authorization safe? Can the merchant charge me anything they want?

Can I cancel my subscription?

How do I revoke a subscription from my own wallet?

Can I pay with a different wallet, token, or network?

Can I switch to a different plan later?

If I upgrade, do I pay twice?

What happens if a recurring charge fails?

What if the subscription page expires before I authorize it?

Why does Woldy need my email if there's no account?

Do I need a Woldy account to subscribe?

What you'll need#

How to subscribe#

What you're actually authorizing#

Why we ask for your email#

Changing your plan#

How to switch plans#

What happens for each kind of change#

Paying from a different wallet, token, or network#

Cancelling your subscription#

If a payment can't go through#

Supported wallets#

Security#

What is Permit2?#

The Permit2 approval vs. your subscription authorization — and why it's safe#

Common questions#