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

​

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. Create customer (KYC auto-approves in sandbox)
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());

// 3. Create virtual account
const { data: account } = await fetch(`${BASE}/business/virtual-account/create`, {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': crypto.randomUUID() },
  body: JSON.stringify({
    customer_id: customer.data.customer_id,
    currency: 'BRL',
  }),
}).then(r => r.json());

console.log('Test account number:', account.data.account_number);

​

Differences from Production

• KYC is instant — submit a customer and is_kyc_submitted / is_va_approved are set immediately
• 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

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. Real customers will need to complete KYC (not auto-approved)
4. Update your webhook URL to point to your production endpoint