Converter saldo MXN → BRL
https://api.zypfy.com/api/accounts/mxn/convertConverte parte (ou todo) do seu saldo em MXN (balance_mxn) para
reais (BRL), creditando o balance normal. Use isto antes de sacar via
PIX: o depósito México cai em MXN, você converte para R$ aqui e então saca
com POST /api/withdrawals/withdraw.
O câmbio é definido pela Zypfy (não é enviado por você) e retorna no
campo rate da resposta. A conversão é atômica: debita amount do
balance_mxn e credita amount × rate no balance.
Corpo da requisição
amountnumberobrigatórioValor em MXN (pesos) a converter. Deve ser ≤ balance_mxn.
exemplo:500
Respostas
200Conversão realizada.
messagestringconverted_mxnnumberexemplo:500credited_brlnumberexemplo:150ratenumberexemplo:0.3balance_mxnnumberSaldo MXN após a conversão
exemplo:0balancenumberSaldo BRL após a conversão
exemplo:150
400Valor inválido ou saldo MXN insuficiente
(code: "INSUFFICIENT_MXN_BALANCE" traz detail.available_mxn).
messagestringMensagem humana descrevendo o erro.
exemplo:Invalid amount.codestring | nullCódigo opcional de erro para roteamento no seu sistema.
min_amountnumber (float) | nullPresente em erros de valor abaixo do mínimo configurado.
max_amountnumber (float) | nullPresente em erros de valor acima do máximo absoluto.
limitnumber (float) | nullPresente em erros de limite diário por transação excedido.
retry_after_secondsinteger | nullPresente em erros
WITHDRAWAL_COOLDOWN/ 429.
503Câmbio não configurado no momento (code: RATE_UNAVAILABLE).
messagestringMensagem humana descrevendo o erro.
exemplo:Invalid amount.codestring | nullCódigo opcional de erro para roteamento no seu sistema.
min_amountnumber (float) | nullPresente em erros de valor abaixo do mínimo configurado.
max_amountnumber (float) | nullPresente em erros de valor acima do máximo absoluto.
limitnumber (float) | nullPresente em erros de limite diário por transação excedido.
retry_after_secondsinteger | nullPresente em erros
WITHDRAWAL_COOLDOWN/ 429.