Skip to main content
Test the full payment flow in sandbox before switching to live. No real money moves in sandbox.

​
Use the sandbox environment

Authenticate with a sandbox secret key. The base URL is the same as live — the environment is determined by the key. 
curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_sandbox_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 50, "currency": "XOF", "description": "Test order",
        "customer": { "email": "[email protected]", "first_name": "Test", "last_name": "User" } }'
Sandbox is fully isolated from live: gateway accounts, payments and keys never cross over. See Environments.

​
Test Payment Gateway

Every sandbox project ships with a built-in Test Payment Gateway, wired to a dedicated test payment method and routed automatically — there is no gateway account to configure. Attempt a sandbox payment with method_code set to test; the last two digits of the payer phone number select the outcome.

​
Simulate scenarios

The outcome is driven by the last two digits of the payer phone number, so any valid number from any country works — only the ending matters:
  • ends in 01 → pending
  • ends in 02 → failed
  • any other ending → success
The US numbers below are just convenient examples; any valid number ending the same way triggers the same scenario (e.g. an Ivorian +225…01 is also pending, a +225…02 is also failed).
ScenarioExample phone numberResult
Successful payment+1 415 555 0100Attempt and intent reach completed.
Pending payment+1 415 555 0101Attempt stays processing; it resolves to completed on verification / reconciliation.
Failed payment+1 415 555 0102Attempt becomes failed with a failure reason.
curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_sandbox_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000, "currency": "USD", "description": "Test order",
    "customer": { "email": "[email protected]", "first_name": "Test", "last_name": "User" },
    "attempt": {
      "method_code": "test", "country": "US",
      "phone": { "number": "+14155550102", "country": "US" }
    }
  }'
The Test Payment Gateway and its test method exist only in sandbox — they never appear in live. Use a number ending in 01 or 02 to exercise the pending and failed paths.

​
Test with a provider’s sandbox

To test against a real provider, add a sandbox gateway account with that provider’s sandbox credentials and route to it. Provider-specific test phone numbers, cards and OTPs come from each provider’s own sandbox documentation.

​
Test webhooks

Point webhook_url at a publicly reachable URL (use a tunnel such as ngrok in local dev). Orqex delivers the same events in sandbox; verify your handler by re-fetching the payment. See Webhooks.

​
Go live

Once your flows pass in sandbox, swap the sandbox key for a live key — no code or URL change is required.