Skip to content
Last updated

Banxa provides a full sandbox environment for integration testing. The sandbox mirrors production behaviour — you can create orders, go through the complete checkout flow, and receive webhook notifications — without processing real money or crypto.


Sandbox environment

SandboxProduction
Base URLhttps://api.banxa-sandbox.com/{partner}/https://api.banxa.com/{partner}/
Checkout URLhttps://{partner}.banxa-sandbox.comhttps://{partner}.banxa.com
Real transactionsNoYes
Test credentialsYesReal payment details only

Replace {partner} with your partner name (also called your merchant name or environment name), provided during onboarding — for example, https://api.banxa-sandbox.com/acmewallet/.

Your sandbox credentials (API key, partner reference) are separate from production and are provided during onboarding.


What you can test in sandbox

  • The full customer checkout flow (KYC, payment, order completion)
  • Webhook delivery and order status transitions
  • Quote pricing and order creation via the API
  • Referral URL construction and parameter pre-population
  • iFrame and WebView embedding
  • KYC sharing and Sumsub token integration

Testing checklist

Before requesting production access, complete the following:

  • Create at least one buy order via your chosen integration method (API or Referral)
  • Complete a full checkout using sandbox test credentials
  • Confirm order status reaches complete
  • Receive and handle at least one webhook notification
  • Verify your redirectUrl is called correctly on checkout completion
  • (If applicable) Test KYC sharing by calling the identity endpoint before checkout
  • (If applicable) Test the off-ramp flow end-to-end (custodial: verify webhook receipt and deposit address retrieval)

Next steps

Sandbox Test Data — test credentials and payment details End-to-End Testing — step-by-step test flow