Pular para o conteúdo principal
O Dodo Payments fornece notificações de webhook em tempo real para mantê-lo informado sobre eventos críticos relacionados a transações, assinaturas, reembolsos, disputas e gerenciamento de chaves de licença. Abaixo está um guia detalhado para esses eventos, categorizados para clareza, juntamente com dicas e considerações de implementação.

Eventos de Pagamento

Nome do EventoTipo de EventoDescrição
Pagamento Bem-Sucedidopayment.succeededAcionado quando um pagamento é processado com sucesso.
Pagamento Falhoupayment.failedOcorre quando uma tentativa de pagamento falha devido a erros, cartões recusados ou outros problemas.
Pagamento em Processamentopayment.processingIndica que um pagamento está atualmente sendo processado.
Pagamento Canceladopayment.cancelledAcionado quando um pagamento é cancelado antes da conclusão.

Eventos de Reembolso

Nome do EventoTipo de EventoDescrição
Reembolso Bem-Sucedidorefund.succeededAcionado quando um reembolso é processado com sucesso.
Reembolso Falhourefund.failedOcorre quando uma tentativa de reembolso falha devido a erros de processamento ou outros problemas.

Eventos de Disputa

Nome do EventoTipo de EventoDescrição
Disputa Abertadispute.openedAcionado quando um cliente inicia uma disputa.
Disputa Expiradadispute.expiredIndica que uma disputa expirou sem resolução.
Disputa Aceitadispute.acceptedAcionado quando um comerciante aceita a disputa.
Disputa Canceladadispute.cancelledOcorre quando uma disputa é cancelada pelo cliente ou pelo sistema.
Disputa Contestadadispute.challengedAcionado quando um comerciante contesta uma disputa.
Disputa Vencidadispute.wonIndica que o comerciante venceu uma disputa com sucesso.
Disputa Perdidadispute.lostOcorre quando o comerciante perde uma disputa.

Eventos de Assinatura

Nome do EventoTipo de EventoDescrição
Assinatura Ativasubscription.activeIndica que uma assinatura agora está ativa e cobranças recorrentes estão agendadas.
Assinatura Atualizadasubscription.updatedAcionado quando qualquer campo de assinatura é atualizado (sincronização em tempo real sem polling).
Assinatura Em Esperasubscription.on_holdAcionado quando uma assinatura é temporariamente colocada em espera devido a falha na renovação.
Assinatura Renovadasubscription.renewedOcorre quando uma assinatura é renovada com sucesso.
Plano de Assinatura Alteradosubscription.plan_changedAcionado quando uma assinatura é atualizada, rebaixada ou modificada com diferentes complementos.
Assinatura Canceladasubscription.cancelledAcionado quando uma assinatura é cancelada pelo comerciante ou cliente.
Assinatura Falhousubscription.failedIndica uma assinatura falhada. Isso significa que não conseguimos criar um mandato.
Assinatura Expiradasubscription.expiredAcionado quando uma assinatura atinge o final de seu prazo e expira.

Eventos de Chave de Licença

Nome do EventoTipo de EventoDescrição
Chave de Licença Criadalicense_key.createdAcionado quando uma nova chave de licença é criada para um produto.
Esses eventos de webhook são projetados para fornecer aos comerciantes atualizações críticas para gerenciar suas operações de forma eficaz. Implemente manipuladores robustos para cada evento relevante em sua integração de webhook para garantir uma funcionalidade suave e confiável.