Central de Ajuda

Leitura de 4 min

Reenvio Webhook Pagamento API BTG Pactual

Atenção, Beta!

A integração com a API BTG Pactual está presente na versão Beta do Sistema. Sua disponibilidade na versão Estável será a partir de Julho de 2025.

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

graph TD
    A[Início] --> B[Acesse o Internet Banking BTG Pactual]
    B --> C[Faça login]
    C --> D[Clique em Integrações]
    D --> E[Clique em Ir para Developers]
    E --> F[Clique em Aplicativos]
    F --> G[Altere o ambiente para Produção]
    G --> H[Localize o aplicativo e clique em Detalhes]
    H --> I[Clique na aba Webhooks]
    I --> J[Clique em Eventos na coluna Ações]
    J --> K[Visualize os eventos de webhooks]
    K --> L[Localize ou filtre eventos]
    L --> M1[Reenvio individual - Clique em ver detalhes e Reenviar evento]
    L --> M2[Reenvio em massa - Defina datas e clique em Reenviar eventos]
    M1 --> N[Webhook será reenviado]
    M2 --> N[Webhook será reenviado]
    N --> O[Fim]

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.

Etiquetas

IntegracaoBancaria GatewayBancario BTGPactual GatewayDePagamento BoletoHibrido BoletoPix Pix Reenvio LogsGateway

Leia Também

Explore nossos produtos!

IXC ACS
Opa! Suite
IXC ONER

Páginas relacionadas