Skip to content
CryptonlyCryptonlyCryptonly

x402 payouts and fees

Payments go to one of two places. You choose for each network under Settings → Payouts.

Your own wallet

Base and Solana. Payments go straight to you, and Cryptonly never holds the money. Fees come from prepaid x402 credits.

Your Cryptonly balance

Base only. Payments are added to your balance, where you can convert or withdraw them. The fee is taken from each payment.

Open payout settings
Where you get paid card on Base: Own wallet selected, Cryptonly balance as the other option, and the wallet that is paid.Where you get paid card on Base: Own wallet selected, Cryptonly balance as the other option, and the wallet that is paid.

Your own wallet

Section titled “Your own wallet”

Click Verified wallets → Add wallet and sign a message to prove the wallet is yours. Browser wallets and Safe multisigs both work. With several wallets, click Use as payTo on the one that should get paid.

Cryptonly only pays wallets you added. A payment to any other address fails with pay_to_rejected.

Solana wallets

Section titled “Solana wallets”

Any wallet that signs messages works, such as Phantom or Solflare.

On Solana, a wallet needs a token account for each token before it can receive it. A wallet that has ever held USDC or USDT already has one. Otherwise, send it a small amount of the token once. Token accounts shows which tokens are ready, and payments in any other token are refused.

Where you get paid card on Solana: the Phantom wallet is paid, its USDC token account is ready, and USDT has no token account, so USDT payments are refused.Where you get paid card on Solana: the Phantom wallet is paid, its USDC token account is ready, and USDT has no token account, so USDT payments are refused.

Cryptonly balance (Base)

Section titled “Cryptonly balance (Base)”

Select Cryptonly balance and save. Your account gets a settlement address on Base for buyers to pay. With prices in the dashboard, the middleware uses it automatically. With prices in code, set it as payTo in your routes.

Where you get paid card on Base with Cryptonly balance selected: the settlement address, and notes on crediting, fees and sweeps.Where you get paid card on Base with Cryptonly balance selected: the settlement address, and notes on crediting, fees and sweeps.

Each payment is added to your balance, minus the fee, after 10 Base blocks (about 20 seconds). Direct transfers to this address are added too, a few minutes after they confirm.

Fees

Section titled “Fees”
Fee
First 100 payments each month, across all your accountsFree
After that, own wallet$0.0025 per payment, from x402 credits
After that, Cryptonly balance$0.0025 per payment, taken from the payment in the paid token
Failed and refused paymentsFree
SandboxFree

x402 credits

Section titled “x402 credits”

Credits are a prepaid USDC balance that pays the fees for own-wallet payments. One balance covers Base and Solana.

Fee plan card: 100 of 100 free payments used this month, $0.0025 per payment paid from x402 credits, $4.20 of credits, auto top-up from 1 to 5 USDC, and a history of fees and top-ups.Fee plan card: 100 of 100 free payments used this month, $0.0025 per payment paid from x402 credits, $4.20 of credits, auto top-up from 1 to 5 USDC, and a history of fees and top-ups.
  • Top up moves USDC from your account balance into credits. Move to balance moves it back.
  • Auto top-up adds credits when they run low, for example “add 5 USDC when below 1 USDC”. It needs enough USDC on your balance.
  • History lists every top-up and fee.

When credits run out, payments fail with fee_balance_insufficient. The dashboard warns you before that happens.

Top up credits
Section titled “Related pages”
Payments and webhooksPayment history, statuses and webhooks
Balances and conversionsConvert or withdraw what lands on your balance