Merchant API requests can run against sandbox or production.
Sandbox
Use sandbox while building and testing. Add this header:
Sandbox lets you test request shapes, references, callbacks, and reconciliation before moving to live activity.
Production
Production is used when the environment header is omitted or set to a non-sandbox value.
Use production only after you have tested:
- Authentication.
- Collections.
- Transfers.
- Swaps.
- Callback handling.
- Transaction reconciliation.
Recommended rollout
- Build with sandbox keys.
- Send test requests with unique references.
- Confirm your system receives callbacks.
- Confirm transactions appear in the dashboard.
- Switch to production keys and remove the sandbox header.
Last modified on July 7, 2026
