Pular para o conteúdo principal
Obtenha cotações de câmbio em tempo real com taxas seguras baseadas em tokens para suas transações internacionais. A API de Cotação de Câmbio permite obter taxas de câmbio entre diferentes moedas e receber um token seguro que fixa a taxa cotada por um período específico. Isso garante a consistência da taxa para suas transações subsequentes, além de proteger contra a volatilidade do mercado.

Pré-requisitos

Antes de solicitar cotações de câmbio, certifique-se de ter:
  • Credenciais de API válidas com permissões para conversão de moeda.
  • Números de contas ativas para as moedas de origem e de cotação.

Endpoint da API

Para cotar um câmbio, envie uma solicitação GET para o endpoint Obtenha uma cotação de câmbio.

Endpoint

Substitua {type} pelo tipo de transação que melhor se adequa ao seu caso de uso:

Autenticação

Inclua seu token de acesso nos cabeçalhos da solicitação:

Parâmetros-chave da solicitação

Exemplo de solicitação

curl

Tratamento de Respostas

Resposta bem-sucedida

Uma solicitação bem-sucedida retorna informações sobre a taxa de câmbio com um token seguro:

Campos de resposta principais

Respostas de erro


Melhores práticas

Segurança e desempenho

  • Utilize sempre HTTPS para solicitações de API.
  • Armazene os tokens de acesso em local seguro e alterne-os regularmente.
  • Monitore atentamente os prazos de expiração dos tokens.
  • Armazene as cotações em cache adequadamente, mas respeite as datas de expiração.

Importante: Expiração do token

Os tokens de taxa de câmbio têm um prazo de validade limitado. Planeje seu fluxo de trabalho de transação para que seja concluído dentro do período de expiração. A taxa cotada é garantida apenas enquanto o token estiver válido.
Dica profissionalDiferentes métodos de pagamento podem oferecer taxas de câmbio diferentes. Analise todas as opções disponíveis no array quotes para selecionar a taxa mais favorável ao seu caso de uso.

Fluxo de trabalho de integração

  1. Solicite uma cotação: peça taxas de câmbio para o par de moedas desejado.
  2. Selecione o método: escolha o método de pagamento mais adequado entre as cotações.
  3. Armazene o token: salve o exchangeRateToken para a sua transação.
  4. Execute a transação: utilize o token na sua chamada à API de pagamento.
  5. Monitore a validade: conclua a transação antes do expirationDate.

Próximos passos

Processamento de Payins

Processe os Payins usando a moeda convertida.

Processamento de Payouts

Processe os Payouts usando a moeda convertida.

Executar Câmbio de Moedas

Utilize seu token de taxa de câmbio para realizar a conversão de moeda.
Dica profissionalTeste seu fluxo de trabalho minuciosamente em nosso ambiente de sandbox. Isso garante que sua integração lide corretamente com flutuações de taxas, expiração de tokens e cenários de erro antes de entrar em produção.

Precisa de ajuda?Entre em contato com nossa equipe de suporte caso encontre algum problema ou precise de ajuda com a integração.

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