Mainnet remains the recommended way to verify your integration. The sandbox runs on test networks with test liquidity, so it cannot prove production readiness. Before going live, complete the Testing flow with a small real deposit and work through the Production Checklist.
Sandbox endpoints
Sandbox and production share nothing: merchants, keys, and transfers in one environment do not exist in the other.
Enable sandbox mode in the SDK
Passenvironment: 'sandbox' when constructing the SDK. This points the hosted flow at https://pay-sandbox.blink.cash. An explicit webviewBaseUrl always takes precedence over environment.
Register a sandbox merchant
Sandbox merchants are registered with the same flow as production, but against the sandbox API. Generate a key pair following Key Generation — use a dedicated key pair for sandbox, never your production key — and submit it to:merchantId is active immediately, so you can wire it into your signer and start depositing right away.
Supported testnets
Support differs by deposit method:
- One-tap deposits (connected wallet): Base Sepolia and Sepolia only. Cross-chain routing between the two works — for example, depositing Sepolia USDC to a Base Sepolia destination.
- Manual transfers (send from an exchange or wallet): same-chain deposits only, on Base Sepolia and Sepolia. Cross-chain manual transfers are not supported on testnet.
Fund a test wallet
- Testnet USDC — Circle’s testnet faucet supports both Base Sepolia and Sepolia.
- Gas (ETH) — use the Google Cloud faucet for Sepolia or the Coinbase faucet for Base Sepolia.