Central de Ajuda

Aparência

Reenvio Webhook Pagamento API BTG Pactual ​

Introdução ​

O reenvio de webhook API BTG Pactual para notificações de pagamento é um processo essencial para garantir que as informações sobre transações financeiras sejam devidamente comunicadas e processadas nos casos em que ocorrem falhas de comunicação. Este conteúdo apresenta a importância dessa ação, seu funcionamento e o passo a passo para executá-la corretamente. Entender esse processo é importante para manter a integridade das operações financeiras e proporcionar uma experiência positiva para o cliente.

Desenvolvimento ​

O que é o envio de webhook API BTG Pactual ​

O envio de webhook é um mecanismo automatizado usado para notificar o sistema sempre que ocorre um evento de pagamento. Ele mantém o sistema atualizado com o status das transações financeiras.

O recurso de reenvio pode ser utilizado quando há instabilidade ou falhas no recebimento das notificações no sistema, impedindo que os dados de liquidação sejam processados corretamente.

Passo a passo - Reenviando notificações de pagamento webhook API BTG Pactual ​

  1. Início.
  2. Acesse o Internet Banking BTG Pactual.
  3. Faça login na sua conta.
  4. No menu lateral esquerdo, clique em Integrações.
  5. Role até a seção APIs e clique em Ir para Developers.
  6. Acesse o menu Aplicativos.
  7. No canto superior direito, altere o ambiente de Sandbox para Produção.
  8. Localize o aplicativo correspondente às credenciais da carteira de cobrança usada no sistema. Na aba Ações, clique no botão com três pontos e selecione Detalhes.
  9. Na tela de detalhes, acesse a aba Webhooks.
  10. Na linha do URL de Endpoint, clique nos três pontos da coluna Ações e selecione Eventos.
  11. Você verá a lista de todos os eventos de envio de webhook da aplicação. É possível verificar o status da notificação, a data de envio e o endpoint de destino.
  12. Para realizar o reenvio, você pode seguir dois caminhos:
    • Reenvio individual: localize o evento desejado, clique em Ver detalhes e depois em Reenviar evento.
    • Reenvio em massa: na tela de eventos, preencha os campos Data de início e Data final e clique em Reenviar eventos.
  13. O webhook será reenviado ao sistema para processamento, atualizando o status no módulo Contas a Receber, se aplicável.
  14. Fim.
Dica!

Tela de Eventos - Aplicativo BTG Pactual:

  • Quando há sucesso no envio de um Webhook, seu código de status é igual a 200.
  • Quando há falha no envio de um Webhook, seu código de status será diferente de 200.

Fluxo de processo ​

Monitoramento e resolução de problemas ​

Após fazer o reenvio das notificações, acompanhe:

  • A confirmação de recebimento do webhook no sistema.
  • A atualização correta do status da transação.
  • A ausência de falhas ou mensagens de erro no processamento.

Caso continue enfrentando problemas:

  • Verifique se a URL de recebimento (endpoint) está configurada corretamente.
  • Verifique se o certificado SSL do servidor está válido.
  • Analise os logs de erro disponíveis na plataforma.
  • Se necessário, entre em contato com o suporte técnico do banco.

Considerações finais ​

O reenvio de webhooks da API BTG Pactual é um recurso necessário para corrigir falhas pontuais na comunicação entre o banco e o sistema. Usá-lo corretamente garante que todos os pagamentos sejam devidamente contabilizados e registrados. A prática reduz inconsistências nos dados financeiros e melhora a operação diária da empresa, mantendo a confiabilidade e segurança nas transações.

Leia Também ​

Disponibilizado por IXC S.A.

© 2025