API reference

Testing

sk_test_… keys make test sessions (cs_test_…), sk_live_… keys live ones (cs_live_…). The two never meet: a test key cannot see a live session, its events or its refunds, and each mode has its own webhook endpoints. Test payments are never billed. Your production server should take only live events: refuse an event whose livemode is false or whose session is a cs_test_… one.

With a test key everything works as in live mode — the page, the statuses, the webhooks — and no real money moves. A test page shows where to pay only to the project’s owner, or an Admin or Developer of its team, signed in; anyone else is told it is a test. Pay on test networks (Solana devnet, Sepolia, TRON Nile, Bitcoin testnet and the rest) or skip the faucets: open a test payment in the dashboard, or its page, and press Simulate payment for any coin, in full or in part. A simulated transfer goes through the same code as a real one, your webhooks included. On the payment page the button is shown only to them: a buyer given a test link cannot mark it paid.

  • Part of it: the session becomes partially_paid and waits for the rest.
  • Late: a payment that comes after the link ran out by itself is paid late, or held for review if you chose so; it is watched for 24 hours after expiry. Simulate works only while a session is open, so try it on a test network: create a session with a short expires_in and pay it once it has run out.
  • Closed: a link you close yourself (expire) holds whatever still arrives for your review (review_reason closed), whatever your late-payment setting.
  • Webhooks: point a test endpoint at a tunnel (ngrok, Cloudflare Tunnel) to your machine.

Test networks

The test network test mode reads for each network. Where there is none, a payment in its coins is made with Simulate payment only. Test mode never waits on a test network: while one cannot be read, a coin picked on it is offered with Simulate payment only, rather than refused.

NetworkIn test mode
SolanaSolana Devnet
TRONSimulate payment only
EthereumSimulate payment only
BNB ChainSimulate payment only
BaseSimulate payment only
PolygonSimulate payment only
ArbitrumSimulate payment only
OptimismSimulate payment only
AvalancheSimulate payment only
TONTON Testnet
BitcoinBitcoin Testnet
LitecoinSimulate payment only
DogecoinSimulate payment only
Bitcoin CashSimulate payment only
XRP LedgerXRP Ledger Testnet
StellarStellar Testnet

Limits of test mode

Test mode is for trying things, not for load: a test session stays open 2 h at most, an account holds 200 open at once, test keys make 120 POSTs a minute per account, and test payments are read on a budget of their own, so a large test run is seen more slowly. Test sessions, with their payments, events and deliveries, are deleted 30 days after they were made.

This page as Markdown, for a program or an AI assistant: /docs/testing.md. Something missing or unclear? Write to us from the dashboard’s Help & Support.