Convert Currency
API Documentation · Zypher Global
Introduction
Authentication
Sandbox
PIX charge (BRL)
SPEI charge (MXN)
USDT charge
PIX withdrawal (key)
BR Code withdrawal
SPEI withdrawal (MXN)
USDT withdrawal
Splits (pass-through)
Check Balance
Convert Currency
Query Transactions
Webhooks
Error handling
Convert your balance between BRL, MXN, USDT at the current rate. Two-step flow: /conversion/simulate returns the quote without touching the balance; /conversion executes (debits the source, credits the destination).
1. Simulate
POST /conversion/simulate · permission cashin
Body
{
"amount": 1000.00,
"from": "BRL",
"to": "MXN"
}
Response
{ "ok": true, "rate": 3.42, "estimated_amount": 3402.90, "fee": 5.00, "from": "BRL", "to": "MXN" }
2. Execute
POST /conversion · permission cashin
Same body as the simulation. Requires a verified (KYC) account. The final amount uses the rate at execution time (may differ from the simulation).
Response
{ "ok": true, "converted_amount": 3402.90, "rate": 3.42, "fee": 5.00, "from": "BRL", "to": "MXN", "status": "confirmed" }
The conversion fee (
fee) is deducted from the source before applying the rate. Insufficient balance in the source currency returns an error without debiting anything.
Was this page helpful?
