Skip to content

Sandbox

Test the failure cases, not just the happy one

The sandbox mirrors the production API exactly, settles instantly, and lets you trigger every failure mode on demand. You do not need to submit documents to start building.

Getting started

Your first sandbox payout

Sandbox request
# Sandbox keys are prefixed sk_test and never move real money.
export SYNTRA_KEY=sk_test_4f2a9c...

curl https://sandbox.syntrapayments.com/v1/payouts \
  -H "Authorization: Bearer $SYNTRA_KEY" \
  -H "Idempotency-Key: first-test-payout" \
  -d source_currency=NGN \
  -d destination_currency=USD \
  -d amount=1000.01 \
  -d beneficiary=bnf_test_001

{
  "id": "po_test_9Xa",
  "status": "failed",
  "failure_reason": "invalid_account"
}

Test triggers

Amounts that force a specific outcome

Send one of these amounts in the sandbox and the payout takes the matching path, so you can build and test error handling before you go live.

AmountWhat happens
1000.01Payout fails with invalid_account
1000.02Payout fails with insufficient_balance
1000.03Payout is held for compliance review
1000.04Quote expires before the payout is created
1000.05Settlement is delayed by five minutes
Any otherPayout settles immediately

Open an account today

Apply in under ten minutes. Most businesses are verified within one working day and send their first payout the day after.