Converter Moeda
Documentação da API · Zypher Global
Introdução
Autenticação
Sandbox
Cobrança PIX (BRL)
Cobrança SPEI (MXN)
Cobrança USDT
Saque PIX (chave)
Saque BR Code
Saque SPEI (MXN)
Saque USDT
Splits (repasse)
Consultar Saldo
Converter Moeda
Consultar Transações
Webhooks
Tratamento de erros
Converta o saldo entre BRL, MXN, USDT pela cotação atual. Fluxo em dois passos: /conversion/simulate devolve a cotação sem mexer no saldo; /conversion executa (debita a origem, credita o destino).
1. Simular
POST /conversion/simulate · permissão cashin
Body
{
"amount": 1000.00,
"from": "BRL",
"to": "MXN"
}
Resposta
{ "ok": true, "rate": 3.42, "estimated_amount": 3402.90, "fee": 5.00, "from": "BRL", "to": "MXN" }
2. Executar
POST /conversion · permissão cashin
Mesmo corpo da simulação. Exige documentos verificados na conta. O valor final usa a cotação do momento da execução (pode diferir da simulação).
Resposta
{ "ok": true, "converted_amount": 3402.90, "rate": 3.42, "fee": 5.00, "from": "BRL", "to": "MXN", "status": "confirmed" }
A taxa de conversão (
fee) é descontada da origem antes de aplicar a cotação. Saldo insuficiente na moeda de origem retorna erro sem debitar nada.
Esta página foi útil?
