# Testing

Part of the Orboni API reference: https://orboni.com/docs. This page: https://orboni.com/docs/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.

| Network | In test mode |
| --- | --- |
| Solana | Solana Devnet |
| TRON | Simulate payment only |
| Ethereum | Simulate payment only |
| BNB Chain | Simulate payment only |
| Base | Simulate payment only |
| Polygon | Simulate payment only |
| Arbitrum | Simulate payment only |
| Optimism | Simulate payment only |
| Avalanche | Simulate payment only |
| TON | TON Testnet |
| Bitcoin | Bitcoin Testnet |
| Litecoin | Simulate payment only |
| Dogecoin | Simulate payment only |
| Bitcoin Cash | Simulate payment only |
| XRP Ledger | XRP Ledger Testnet |
| Stellar | Stellar 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.
