Skip to main content
Start with 1,000 free credits. No sign-up or API key needed. When they run out, buy more credits and keep going.

Free

1,000 free credits
  • No sign-up or API key needed
  • Covers ordinary payments and public batch settlement
  • Testnets are always free

Pay as you go

$1 = 1,000 credits
  • Each payment costs its network’s rate in credits
  • See live rates
Jump to the quickstart to start building.

What a payment costs

One credit is $0.001. Each payment your server settles costs its network’s rate in credits. The rate tracks the on-chain gas PayAI pays to settle on that network, plus 30%, and refreshes daily. It is never a percentage of the payment amount. Testnets are free. For example, if the Solana rate is 1.33 credits: Rates differ by network and change with gas prices. See the live rates for every network. Batch settlement and upto are priced per on-chain transaction, so a channel costs the sum of its legs (deposit, claim, refund and so on). Solana token-account (ATA) setup is a separate cost. Enterprise (invoiced) accounts use the same rates unless their agreement says otherwise.
The facilitator fee is separate from the price your API charges its customer. Payment amounts must satisfy the advertised payment requirements and the selected scheme’s rules. Batch channel deposits have their own limits; they are not the price of each API request.

Reading rates from your server

GET /supported carries the current rates under pricing, so a server can read the price for the network it is about to use. GET https://facilitator.payai.network/pricing returns the same object when you request JSON (Accept: application/json), including any upcoming change and its effective time.

When your free credits run out

When your free credits run out, the facilitator stops settling new payments for that wallet. Its error message includes a top-up link. To keep going:
  1. Open merchant.payai.network/top-up and sign in. The link in the error already has your wallet and network filled in.
  2. Buy credits. Paying with $PAYAI on Solana gets a 10% discount; review the quote before you pay. Your customers do not need $PAYAI to pay your API in USDC.
  3. Add your API key to your server’s environment:
If you use @payai/facilitator (as the TypeScript server guides do), it reads these variables automatically. No code changes are needed. For other languages, see facilitator authentication.
Agents can do this without a person. An agent can buy credits and receive an API key over x402, with no portal signup. PayAI creates a wallet-owned agent account during the purchase. A paying wallet already linked to a portal account receives credits but not a new agent key; manage that account’s keys in the portal. Check whether a wallet still has free credits. Anyone can look up any wallet, so the answer is available, low (20% or less left) or exhausted, not exact numbers. You see exact numbers in the merchant portal after you link the wallet.
Free credits are tracked per receiving wallet, and per account when you use an API key. Very high-volume shared hosts may be asked to use an API key sooner.

Need help?

Join our Community

Have questions or want to connect with other developers? Join our Discord server.