Pular para o conteúdo principal
Fixar uma taxa de câmbio permite garantir o preço da conversão antes de executar uma transação, protegendo você e seus usuários das flutuações do mercado entre a cotação e a execução. Todos os três fluxos: payins, payout e câmbio em lote: seguem o mesmo padrão de duas etapas:
  1. Obtenha uma cotação: Chame a API de cotação de câmbio especificando o tipo de operação (payin, payout ou CurrencyExchange). Você receberá um exchangeRateToken com uma taxa garantida e um prazo de validade.
  2. Use o token: Inclua o exchangeRateToken na sua solicitação de payin, payout ou câmbio em lote. A API aplica a taxa fixada automaticamente.
As seções abaixo usam um payin como exemplo, mas a estrutura é semelhante para payouts e câmbio em lote.
Validade da taxaA taxa fixada só é garantida até a expirationDate do token. Se o token expirar antes de você enviar a transação, a operação usará a taxa de mercado naquele momento.

Cotar um Payin

Use este fluxo quando quiser mostrar a taxa de câmbio ao seu usuário antes de receber um pagamento.

Etapa 1: Solicitar uma cotação

Solicitar
curl
Resposta

Etapa 2: Enviar o payin com o token

Solicitar
curl
Resposta


curl

Mostrar a taxa de câmbio antes do checkout

Se você está criando um checkout e quer exibir a taxa de câmbio ao seu usuário antes de ele confirmar o pagamento, este é o fluxo:
  1. O usuário seleciona um valor e uma moeda.
  2. Seu backend chama a API de cotação de câmbio e recebe a taxa no parâmetro exchangeRateToken.
  3. Seu frontend exibe: “Você pagará 10,000 ARS ≈ 8.37 USD (taxa: 0.000837)”
  4. O usuário confirma.
  5. Seu backend envia o payin com o exchangeRateToken para aplicar a taxa fixada.
Isso garante que a taxa que seu usuário viu seja a taxa aplicada à transação, desde que você envie antes da expirationDate do token.
Dica de design:Exiba a expirationDate na sua interface como uma contagem regressiva (por exemplo, “Taxa válida por 8 horas”). Isso cria a expectativa correta e reduz chamados de suporte quando uma taxa muda entre sessões.

Última modificação em 10 de novembro de 2026