Always test on testnet before mainnet: a staging playbook

Shipping a payment flow straight to mainnet is how teams lose money to misconfigured sweep addresses, wrong chain IDs on treasury wallets, or webhooks pointing at staging URLs. Settlematic includes an org-wide testnet/mainnet toggle in the dashboard header so you rehearse the full lifecycle with fake funds first.

What changes in testnet mode

• Deposit addresses derive for Sepolia, Amoy, Bitcoin testnet, Solana devnet, etc.
• Payment pages display testnet badges so clients do not confuse networks
• Block explorers link to test networks
• Same UI, status machine, and webhooks — different chain IDs

Your finance team learns the product on real workflows without risking production treasury. Engineering validates integrations against the same API paths they will use in production.

The four-role staging pass

Assign owners before you start. Fifteen minutes of structured testing prevents expensive mainnet surprises.

• Finance: create client, build invoice with line items and tax, send payment link
• Ops: pay from a test wallet, verify QR and explorer links on mobile
• Treasury: confirm sweep destinations received expected amounts and splits
• Engineering: verify webhook delivery and API reads for payment.confirmed

Common mistakes testnet catches

Wrong network on a sweep destination is the most frequent issue — a mainnet address saved while the org is in testnet mode, or vice versa. Insufficient gas for token sweeps, misconfigured percentage splits that do not sum to 100%, and webhooks firewalled from Settlematic's delivery IPs are close behind.

Testnet mode uses identical status transitions. If confirming never advances, fix indexer or RPC configuration before inviting production clients.

Checklist before flipping to mainnet

• Sweep destinations reviewed by two people on testnet
• Sample invoice paid end-to-end with documented tx hashes
• Client-facing email template mentions supported assets
• Webhook consumer idempotent and logs event IDs
• Support runbook for underpaid and overpaid states

When to stay on testnet longer

If you are still editing conversion flows weekly, keep mainnet clients on fiat wire while crypto checkout stabilizes. Testnet is not a demo — it is where treasury policy meets reality without burning real funds.