Testnet4 and Mainnet
Manatee API keys are scoped to one Bitcoin network. Manatee uses Bitcoin Testnet4 for integration tests; the API represents that network with the value testnet. Use a mainnet key only when you are ready to accept real Bitcoin payments.
Network differences
| Network | Address examples | Coin value | Typical use |
|---|---|---|---|
Testnet4 (API value: testnet) | tb1..., m..., n..., 2... | No real market value | Integration tests, webhook tests, checkout QA |
| Mainnet | bc1..., 1..., 3... | Real BTC | Production payments |
Testnet4 and mainnet addresses are not interchangeable. Do not send real Bitcoin to a Testnet4 address, and do not send testnet coins to a mainnet address.
Testing checklist
- Create a Testnet4 API key (shown as
testnetby the API). - Use a wallet configured for Bitcoin Testnet4.
- 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 Testnet4 and mainnet data separate in your own system so test orders cannot be confused with real payments.