Card test mode is a sandbox setting inside a payment gateway that lets you run checkout, subscription, and refund flows end to end without moving real money. It replaces live processing with simulated authorizations so developers and merchants can confirm an integration behaves correctly before it ever touches a customer's card. Everything stays in a walled-off environment that mirrors live response codes, webhooks, and error handling.
Key Features
- Simulated authorizations, captures, and refunds that never settle to a bank account
- Gateway-issued test card numbers covering approvals, declines, and expired-card errors
- Separate test API keys and endpoints that cannot reach a live account
- Dashboard toggle for switching between sandbox and live processing
- Webhook and API response parity, including decline codes and 3-D Secure test flows
- One-click reset of test customers, charges, and running balances
- Detailed request logs for debugging failed, duplicated, or partial transactions
- No cardholder-data scope in the sandbox, because no real card is ever contacted
Specs and setup
Test mode runs on the same API version as your live account, so request and response shapes stay identical; only the endpoint host and key pair change. Test cards are published by each provider with fixed numbers, future expiration dates, and any CVC value, while 3-D Secure challenges use provider-supplied test credentials. Idempotency keys, metadata fields, and webhook signing secrets all behave as they do in production, which makes a sandbox run a dependable rehearsal for launch-day traffic. Configuration is typically a single key swap in your environment file or dashboard settings panel.
Access and refunds
Digital access is delivered immediately after checkout, with setup notes and configuration examples included. If an activation key fails to work, contact support within 30 days for a replacement or a full refund, and unused keys can be returned at any time. Email support answers setup questions within one business day.
Is card test mode the same as live mode?
No. It mirrors live behavior such as response codes, webhooks, and flow logic, but no funds move and no real card is contacted.
Can test mode tell me whether a real card is valid?
No. Sandbox tools only accept provider-issued test numbers, and entering real cardholder data into a test environment breaks card-network rules and your processor agreement.
How do I turn test mode off?
Switch the dashboard toggle back to live and replace the test key pair in your configuration. The change takes effect on your next API call.