Test Mode

How test mode works

Test mode is determined by the key you use — there is no separate flag or environment to select. A request made with a _sandbox_ key runs in test mode. A request made with a _live_ key runs in live mode.

# Test mode
Authorization: Bearer sk_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Live mode
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Sandbox vs live keys

Both key types exist for both modes:

Mode	Secret key	Publishable key
Sandbox	`sk_sandbox_...`	`pk_sandbox_...`
Live	`sk_live_...`	`pk_live_...`

Find your keys in Settings → API Keys in the dashboard.

Test cards

Use test card numbers to simulate payment outcomes. See Test Cards for all accepted values.

For BECS direct debit testing, use BSB 062-000 with any account number.

Behavior in test mode

PSP calls are mocked — no real card processing occurs
Webhook events fire identically to live mode
API request and response shapes are identical
Data is isolated — test records are not visible in live mode

Moving to live

Replace all _sandbox_ keys with _live_ keys
Ensure your account has completed the compliance review (Settings → Compliance)
Verify webhook endpoints point to production URLs