Initial setup
Complete this baseline setup before implementing service-specific flows
Access and credentials
- The
md-api-keyheader authenticates every request. - Keys provide full account-level access — store them in backend infrastructure only.
- Key rotation is required every 12 months.
- For restricted environments: IP whitelisting and VPN access are available on request.
See Authentication for header format and error handling.
Sandbox test resources
Crypto faucet
Fund test wallets with sandbox tokens at faucet.manteca.dev.
| Chain | Asset | Contract address |
|---|---|---|
| BNB Testnet | USDT | 0x3eC7DA586A34589157e0B3AFA5F9eFADa51f36ec |
| Polygon Amoy | USDT | 0x8431eBc62F7B08af1bBf80eE7c85364ffc24ae24 |
| ETH Sepolia | USDT | 0x33623435D98fD040DBd382B2076C638C45BfEa6b |
| Optimism Sepolia | USDC | 0x177AAE8822048B9dD840C9816CD0e9654924c261 |
| Worldchain Sepolia | USDC | 0x7b66f92D421C8c9Ea12F328d6335e08590AaF4D4 |
| Arbitrum Sepolia | USDC | 0x8431ebc62f7b08af1bbf80ee7c85364ffc24ae24 |
| Base Sepolia | USDC | 0x8431eBc62F7B08af1bBf80eE7c85364ffc24ae2 |
QR payment test codes
| Code | Payment type | Behavior |
|---|---|---|
qr3 | Argentina dynamic QR | Normal success flow |
pix | Brazil dynamic Pix | Normal success flow |
pixmanualamount | Brazil static Pix | Amount entered manually |
Append "failure" to the destination to force a payment failure. Append "refund" to trigger a refund after ~30 seconds.
⚠️ Sandbox-specific behaviors
| Scenario | How to trigger |
|---|---|
| User onboarding rejected | Create a user whose name contains "fail" |
| Fiat withdrawal failure | Fiat withdrawals succeed or fail randomly — test both paths |
Webhooks baseline
Webhooks are required for lifecycle tracking. Before running end-to-end tests, configure a reachable HTTPS endpoint that returns 2xx within 10 seconds.
See Webhooks for signature verification, retry schedule, and event reference.
Sandbox readiness checklist
| Area | What to validate |
|---|---|
| Onboarding | User creation and status progression through onboarding tasks |
| Funds movement | Deposits, withdrawals, and balance impact |
| Execution lifecycle | Status transitions for orders, synthetics, and payments |
| Reconciliation | Operational queries and reporting consistency |
| Webhooks | Event delivery, signature validation, and retry handling |
Go-live process
- Confirm intended use case and service scope with your integration manager.
- Validate integration quality against the sandbox readiness checklist above.
- Confirm compliance and operational controls are in place.
- Complete production homologation (final validation and approval process).
- Exchange production credentials.
Updated 8 months ago
What’s Next
Did this page help you?