Pré-requisitos
Antes de criar câmbio de moedas, certifique-se de ter:- Credenciais de API válidas com permissões de câmbio de moeda.
- Números de contas ativas para as moedas de origem e de destino.
- Saldo suficiente em sua conta na moeda de origem.
Endpoint da API
Para criar conversões em massa, envie uma solicitaçãoPOST para o endpoint Criar conversão de câmbio em massa.
Endpoint
Autenticação
Inclua seu token de acesso em todas as solicitações da API:Parâmetros-chave da solicitação
Exemplo de solicitação (Argentina)
curl
Tratamento de Respostas
Resposta bem-sucedida
Uma transação de câmbio bem-sucedida retorna os seguintes detalhes:Campos de resposta principais
Resposta de erro
Fundos insuficientes
Rastreamento do status da transação
Monitore suas conversões de moeda por meio de múltiplos canais:Webhooks (Recomendado)
Receba notificações em tempo real quando o status da transação mudar. Ideal para ambientes de produção.
Endpoint da API de Status
Consultar o status da transação programaticamente. Útil para consultar ou recuperar notificações de webhook perdidas.
Visualização do Business Portal
Interface visual para monitoramento de transações. Ideal para supervisão manual e análise detalhada de transações.
Ciclo de vida do status
Referência completaConsulte todos os códigos de status em nossa Documentação de Status da Transação.
Recursos avançados
Utilizando cotações de taxas de câmbio
Garanta taxas vantajosas gerando orçamentos antecipadamente:- Gerar cotação: Chame a API de cotação de câmbio
- Obter token: Extraia o
exchangeRateTokenda resposta - Aplicar Token: Inclua o token em sua solicitação de troca em massa.
Dicas de processamento em massa
Otimização de desempenho- Solicitações em lote: Agrupe várias trocas em chamadas de API únicas sempre que possível.
- Limitação de taxa: Implemente um mecanismo de recuo exponencial para processamento de alto volume.
- Tratamento de webhooks: Utilize webhooks em vez de sondar o status por meio de polling.
- Lógica de repetição em caso de erro: Implemente mecanismos inteligentes de repetição para falhas temporárias.
Testes e Validação
Ambiente de Sandbox
Teste sua integração em nosso ambiente de sandbox:Cenários de teste
Valide esses cenários antes de entrar em produção:- Câmbio de moeda bem-sucedido com contas válidas
- Tratamento de erros por insuficiência de fundos
- expiração do token de taxa de câmbio
- Tratamento de números de conta inválidos
- cenários de tempo limite de rede
- Processamento de notificações de webhook
Recursos e próximos passos
Maximize o sucesso da sua integração com estes recursos essenciais.Integração de Webhook
Configure notificações em tempo real para atualizações do status das transações.
Relatórios do Business Portal
Acesse análises detalhadas, ferramentas de geração de relatórios e recursos de conciliação.
Monitoramento de transações
Aprenda a consultar o status das transações e a implementar um rastreamento abrangente.
Referência da API
Documentação completa dos endpoints com exemplos interativos.
Dica profissionalSempre teste seu fluxo de trabalho em nosso ambiente de sandbox antes de implantá-lo em produção. Isso garante que o tratamento de erros, o processamento de webhooks e o rastreamento de status funcionem corretamente em todos os cenários.
Precisa de ajuda?Entre em contato com nossa equipe de suporte caso encontre algum problema ou precise de ajuda com a integração.

