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çãoGET para o endpoint Obtenha uma cotação de câmbio.
Endpoint
{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
- Moeda local (Payin)
- Stablecoin (USDC / USDT)
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:- Local currency (PayIn)
- Stablecoin (USDC / USDT)
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
- Solicite uma cotação: peça taxas de câmbio para o par de moedas desejado.
- Selecione o método: escolha o método de pagamento mais adequado entre as cotações.
- Armazene o token: salve o
exchangeRateTokenpara a sua transação. - Execute a transação: utilize o token na sua chamada à API de pagamento.
- 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.

