ZypfyDocs Acessar painel
Depósitos MXN (México)

Converter saldo MXN → BRL

POSThttps://api.zypfy.com/api/accounts/mxn/convert

Converte 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

Respostas

200Conversão realizada.
  • messagestring
  • converted_mxnnumber
    exemplo: 500
  • credited_brlnumber
    exemplo: 150
  • ratenumber
    exemplo: 0.3
  • balance_mxnnumber

    Saldo MXN após a conversão

    exemplo: 0
  • balancenumber

    Saldo BRL após a conversão

    exemplo: 150
400Valor inválido ou saldo MXN insuficiente (code: "INSUFFICIENT_MXN_BALANCE" traz detail.available_mxn).
  • messagestring

    Mensagem humana descrevendo o erro.

    exemplo: Invalid amount.
  • codestring | null

    Código opcional de erro para roteamento no seu sistema.

  • min_amountnumber (float) | null

    Presente em erros de valor abaixo do mínimo configurado.

  • max_amountnumber (float) | null

    Presente em erros de valor acima do máximo absoluto.

  • limitnumber (float) | null

    Presente em erros de limite diário por transação excedido.

  • retry_after_secondsinteger | null

    Presente em erros WITHDRAWAL_COOLDOWN / 429.

503Câmbio não configurado no momento (code: RATE_UNAVAILABLE).
  • messagestring

    Mensagem humana descrevendo o erro.

    exemplo: Invalid amount.
  • codestring | null

    Código opcional de erro para roteamento no seu sistema.

  • min_amountnumber (float) | null

    Presente em erros de valor abaixo do mínimo configurado.

  • max_amountnumber (float) | null

    Presente em erros de valor acima do máximo absoluto.

  • limitnumber (float) | null

    Presente em erros de limite diário por transação excedido.

  • retry_after_secondsinteger | null

    Presente em erros WITHDRAWAL_COOLDOWN / 429.