Skip to content

Test Mode

Use test mode to build and verify your integration without processing real payments.

How it works

Test mode uses the same API endpoints as live mode. The only difference is the API key prefix:

  • Test keys: sk_test_... / pk_test_...
  • Live keys: sk_live_... / pk_live_...

Test mode behavior

FeatureTest modeLive mode
Virtual accountsCreated (VFD sandbox)Created (VFD production)
Dynamic PayIDsCreatedCreated
WebhooksDeliveredDelivered
Real money movementNoYes
Domain restrictionsLocalhost always allowedEnforced

Getting test keys

  1. Log in to the Dashboard
  2. Go to Developers > API Keys
  3. Create a key pair — test keys are generated by default

Testing payments

In test mode, checkout sessions are created normally. To simulate a completed payment, use the dashboard or wait for test webhook triggers.

TIP

Always verify your webhook handling works correctly in test mode before going live.

ZevPay Checkout Developer Documentation