APP iPag: Como criar webhooks

1. Acesse o ícone de configurações, localizado no canto superior direito da tela, e clique em “Configurar Webhooks”.

2. Em seguida, clique no ícone “+”, localizado à esquerda da tela.

3. Na janela “Adicionar Novo Webhook”, preencha as informações conforme descrito:

• Descrição: insira um nome que facilite a identificação do webhook.

• URL de retorno: informe a URL cadastrada em sua plataforma para o recebimento das notificações.

• Método HTTP: selecione POST.

• Eventos: selecione os eventos que deseja receber em seu sistema.

Eventos Disponíveis para Configuração de Webhooks

A seguir, apresentamos a lista completa dos eventos disponíveis para configuração dos Webhooks, com suas respectivas descrições.

> Eventos de Link de Pagamento

• PaymentLinkPaymentSucceeded
  O link de pagamento recebeu um pagamento aprovado.

• PaymentLinkPaymentFailed
  O link de pagamento recebeu um pagamento recusado.

> Eventos de Assinaturas

• SubscriptionPaymentSucceeded
  O pagamento da assinatura foi processado com sucesso.

• SubscriptionPaymentFailed
  O pagamento da assinatura foi processado com falha.

> Eventos de Cobranças

• ChargePaymentSucceeded
  O pagamento da cobrança foi processado com sucesso.

• ChargePaymentFailed
  O pagamento da cobrança foi processado com falha.

> Eventos de Transações

• TransactionCreated
  A transação foi criada.

• TransactionWaitingPayment
  A transação está aguardando o pagamento do boleto.

• TransactionCanceled
  A transação foi cancelada com sucesso.

• TransactionPreAuthorized
  A transação foi pré-autorizada com sucesso.

• TransactionCaptured
  A transação foi capturada com sucesso.

• TransactionDenied
  A transação teve a autorização recusada pela adquirente.

• TransactionDisputed
  A transação sofreu disputa pelo pagador/cliente.

• TransactionChargedback
  A transação foi estornada e o valor devolvido ao pagador/cliente.

> Eventos de Transferências

• TransferPaymentSucceeded
  A transferência foi realizada com sucesso.

• TransferPaymentFailed
  A transferência foi realizada com falha.

Mais informações e documentação da API

Para validar a integração, consultar exemplos de payload e conhecer todos os parâmetros disponíveis, acesse a documentação completa da API:

https://developers.ipag.com.br/pt-br/webhook?id=webhook-

Essa documentação permite que você teste os eventos, configure Webhooks corretamente e garanta que seu sistema receba todas as notificações de forma confiável.

Para editar, clique nos 3 pontos. 

Editar:  É possível alterar a descrição, a URL e os eventos.

Desativar: caso não queira mais receber os eventos por meio de um determinado webhook, clique em Desativar.

Ativar: caso o webhook esteja inativo e queira voltar a receber os eventos, clique em Ativar.