- Obtenha uma cotação: Chame a API de cotação de câmbio especificando o tipo de operação (
payin,payoutouCurrencyExchange). Você receberá umexchangeRateTokencom uma taxa garantida e um prazo de validade. - Use o token: Inclua o
exchangeRateTokenna sua solicitação de payin, payout ou câmbio em lote. A API aplica a taxa fixada automaticamente.
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
Solicitarcurl
Etapa 2: Enviar o payin com o token
Solicitarcurl
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:- O usuário seleciona um valor e uma moeda.
- Seu backend chama a API de cotação de câmbio e recebe a taxa no parâmetro
exchangeRateToken. - Seu frontend exibe: “Você pagará 10,000 ARS ≈ 8.37 USD (taxa: 0.000837)”
- O usuário confirma.
- Seu backend envia o payin com o
exchangeRateTokenpara aplicar a taxa fixada.
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.
