Pular para o conteúdo principal
A API de Conversão de Moedas em Massa permite que você execute transações de individuais ou múltiplas de forma programática, com taxas otimizadas e eficiência de processamento.

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.
ImportanteVocê pode gerar previamente cotações de taxa de câmbio usando nossa API de Cotação de Câmbio e fixar as taxas incluindo o exchangeRateToken em sua solicitação em massa.

Endpoint da API

Para criar conversões em massa, envie uma solicitação POST 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:
  1. Gerar cotação: Chame a API de cotação de câmbio
  2. Obter token: Extraia o exchangeRateToken da resposta
  3. 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.

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