Sandbox Environment

​

Sandbox Base URL

https://smtp.yativo.com/api/v1

​

Getting Started

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:

curl 'https://smtp.yativo.com/api/v1/ip-whitelist/check' \
  -H 'X-Api-Key: YOUR_SANDBOX_API_KEY' \
  -H 'X-Api-Secret: YOUR_SANDBOX_API_SECRET'

​

Sandbox Behavior

​

Sandbox simulation endpoints

​

How to Test

​

Example: Full Sandbox Test Flow

const BASE = 'https://smtp.yativo.com/api/v1';

// 1. Authenticate with your sandbox API key
const headers = {
  'X-Api-Key': process.env.YATIVO_API_KEY,
  'X-Api-Secret': process.env.YATIVO_API_SECRET,
  'Content-Type': 'application/json',
  'Idempotency-Key': crypto.randomUUID(),
};

// 2. Your account has to be approved before customer and payment calls succeed.
const { data: profile } = await fetch(`${BASE}/profile`, { headers }).then(r => r.json());
console.log(profile.kyc_status, profile.is_kyc_submitted);

// 3. Create a customer. This does not approve KYC.
const { data: customer } = await fetch(`${BASE}/customer`, {
  method: 'POST', headers,
  body: JSON.stringify({
    customer_name: 'Test User',
    customer_email: 'test@example.com',
    customer_phone: '+5511999999999',
    customer_country: 'BRA',
    customer_type: 'individual',
  }),
}).then(r => r.json());

console.log('Customer:', customer.customer_id);
// Submit KYC at https://kyc-sandbox.yativo.com/individual/{customer_id}
// Create a virtual account only after the customer's endorsement for the
// currency is "approved" (endorsement.updated webhook or GET /customer/{customer_id}).

​

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 — credit a wallet with POST /wallet/sandbox/topup. 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

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