Skip to main content
The Yativo sandbox lets you develop and test your integration without moving real funds. Your account and each customer still have to pass verification before payment calls succeed. See Sandbox KYC.

Sandbox Base URL

All other endpoints remain the same — just swap the base URL.

Getting Started

You use the same Yativo account for both sandbox and production. Switch between environments by changing the base URL and the API key in your requests.
  1. Sign up at app.yativo.com (if you haven’t already)
  2. Create a sandbox API key — in your sandbox dashboard, go to Developers → API Keys. Sandbox and production keys are separate.
  3. Call the sandbox base URL with your sandbox key:

Sandbox Behavior


How to Test

1

Use the sandbox base URL

Set https://smtp.yativo.com/api/v1 as your base URL in all requests.
2

Authenticate

Create a separate API key in your sandbox dashboard. Sandbox and production keys aren’t interchangeable.
3

Verify your sandbox account

Complete business verification in the sandbox dashboard. Most API calls return 403 until kyc_status is approved and is_kyc_submitted is true. See Sandbox KYC.
4

Create test customers

Use POST /customer to create customers. That call does not approve the customer. Submit KYC or KYB on https://kyc-sandbox.yativo.com, the same way you do in production.
5

Create virtual accounts

After the customer’s endorsement for the currency is approved, call POST /business/virtual-account/create. See Track verification with endorsements.
6

Simulate deposits

Use the sandbox dashboard or API to trigger test deposits to your virtual accounts.
7

Test payouts

Call POST /sendmoney or POST /wallet/payout — payments are simulated and will transition through statuses.

Example: Full Sandbox Test Flow

Node.js

Differences from Production

  • Account and customer KYC are separate — Sandbox KYC covers both. Creating a customer does not set them to approved
  • No real funds — wallet balances may be pre-funded in sandbox; payouts simulate the full transaction lifecycle
  • Some payment methods may be limited — not all live corridors are available in sandbox; contact your integration team if you need a specific one
  • Webhooks fire normally — you’ll receive all webhook events in sandbox; make sure your test endpoint is reachable

Switching to Production

When you’re ready to go live:
  1. Change your base URL from https://smtp.yativo.com/api/v1 to https://api.yativo.com/api/v1
  2. Ensure your business KYC is approved in the dashboard
  3. Customers complete KYC on https://kyc.yativo.com (sandbox uses https://kyc-sandbox.yativo.com), the same way they do in sandbox
  4. Update your webhook URL to point to your production endpoint
Sandbox and production have separate API keys. Change both the base URL and the API key when you go live.