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 Aprovadopayment.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 Aprovadorefund.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 Ganhadispute.wonIndica que o comerciante ganhou 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 está agora 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 Suspensasubscription.on_holdAcionado quando uma assinatura é temporariamente suspensa 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 pelo 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.