Pular para o conteúdo principal
Notifique a Localpayment sobre uma transferência bancária recebida usando nossa API para liquidar o saldo da sua conta. Este guia orienta você no envio de uma notificação, no tratamento das respostas da API e no acompanhamento do status da transação. Para transações em moeda fiduciária (ex.: USD, ARS, MXN), é necessário nos notificar sobre a transferência recebida. Isso pode ser feito através de:
ImportanteO processo de notificação de Wire In não é utilizado para Stablecoins. Em vez disso, siga o fluxo de Wire In de Stablecoin.
Este guia cobre o fluxo de trabalho da API de ponta a ponta, da notificação à liquidação final.

Antes de começar

Antes de notificar um Wire In, certifique-se de ter:
  • Comprovante da transferência bancária: Prova da transferência externa.
  • Credenciais de API válidas: Com permissões de autorização adequadas.
  • Detalhes completos da transação: Todas as informações necessárias da transação.

Endpoint da API

Para notificar uma liquidação, envie uma requisição POST para o endpoint Criar Wire In.

Endpoint

Autenticação

Inclua seu token de acesso no cabeçalho Authorization:

Parâmetros-chave da solicitação

A solicitação requer vários parâmetros-chave:

Exemplo de solicitação (Argentina)

curl

Tratamento de Respostas

Resposta bem-sucedida

Quando sua solicitação de Wire In for aceita, você receberá uma resposta detalhada:

Campos de resposta principais

Resposta de erro

Exemplo de erro de validação


Acompanhar o status da transação

Após enviar um Wire In, acompanhe o seu progresso através destes métodos:

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.

Códigos de status comuns

Referência completaConsulte todos os códigos de status em nossa Documentação de Status da Transação.

Recomendações de segurança

  • Utilize sempre HTTPS para solicitações de API
  • Armazene os tokens de acesso com segurança (nunca em código do lado do cliente)
  • Implemente tratamento de erros e registro de logs adequados
  • Valide todos os dados de entrada antes de enviar as solicitações

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