Testnet vs Mainnet
Manatee API keys are scoped to one Bitcoin network. Use a testnet key for integration tests and a mainnet key only when you are ready to accept real Bitcoin payments.
Network differences
| Network | Address examples | Coin value | Typical use |
|---|---|---|---|
| Testnet | tb1..., m..., n..., 2... | No real market value | Integration tests, webhook tests, checkout QA |
| Mainnet | bc1..., 1..., 3... | Real BTC | Production payments |
Testnet and mainnet addresses are not interchangeable. Do not send real Bitcoin to a testnet address, and do not send testnet coins to a mainnet address.
Testing checklist
- Create a testnet API key.
- Use a testnet wallet or Testnet4 wallet.
- Send testnet coins from a faucet or test wallet.
- Verify
payment.detectedandpayment.confirmedwebhooks. - Confirm your webhook signature verification uses the raw request body.
- Store payment IDs and event IDs idempotently.
Going to production
Before switching to mainnet, change the API key, wallet address or receive descriptor, confirmation threshold, and webhook endpoint. Keep testnet and mainnet data separate in your own system so test orders cannot be confused with real payments.