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
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:- Open merchant.payai.network/top-up and sign in. The link in the error already has your wallet and network filled in.
- Buy credits. Paying with
$PAYAIon Solana gets a 10% discount; review the quote before you pay. Your customers do not need$PAYAIto pay your API in USDC. - Add your API key to your server’s environment:
@payai/facilitator (as the TypeScript server guides do), it reads these variables automatically. No code changes are needed. For other languages, see facilitator authentication.
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.

