Converter Moeda

Documentação da API · Zypher Global

Gerar credenciais

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?