Initial setup

Complete this baseline setup before implementing service-specific flows

Access and credentials

  • The md-api-key header 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.

ChainAssetContract address
BNB TestnetUSDT0x3eC7DA586A34589157e0B3AFA5F9eFADa51f36ec
Polygon AmoyUSDT0x8431eBc62F7B08af1bBf80eE7c85364ffc24ae24
ETH SepoliaUSDT0x33623435D98fD040DBd382B2076C638C45BfEa6b
Optimism SepoliaUSDC0x177AAE8822048B9dD840C9816CD0e9654924c261
Worldchain SepoliaUSDC0x7b66f92D421C8c9Ea12F328d6335e08590AaF4D4
Arbitrum SepoliaUSDC0x8431ebc62f7b08af1bbf80ee7c85364ffc24ae24
Base SepoliaUSDC0x8431eBc62F7B08af1bBf80eE7c85364ffc24ae2

QR payment test codes

CodePayment typeBehavior
qr3Argentina dynamic QRNormal success flow
pixBrazil dynamic PixNormal success flow
pixmanualamountBrazil static PixAmount entered manually

Append "failure" to the destination to force a payment failure. Append "refund" to trigger a refund after ~30 seconds.


⚠️ Sandbox-specific behaviors

ScenarioHow to trigger
User onboarding rejectedCreate a user whose name contains "fail"
Fiat withdrawal failureFiat 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

AreaWhat to validate
OnboardingUser creation and status progression through onboarding tasks
Funds movementDeposits, withdrawals, and balance impact
Execution lifecycleStatus transitions for orders, synthetics, and payments
ReconciliationOperational queries and reporting consistency
WebhooksEvent delivery, signature validation, and retry handling

Go-live process

  1. Confirm intended use case and service scope with your integration manager.
  2. Validate integration quality against the sandbox readiness checklist above.
  3. Confirm compliance and operational controls are in place.
  4. Complete production homologation (final validation and approval process).
  5. Exchange production credentials.


Did this page help you?