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
Payment Succeededpayment.succeededAcionado quando um pagamento é processado com sucesso.
Payment Failedpayment.failedOcorre quando uma tentativa de pagamento falha devido a erros, cartões recusados ou outros problemas.
Payment Processingpayment.processingIndica que um pagamento está sendo processado no momento.
Payment Cancelledpayment.cancelledAcionado quando um pagamento é cancelado antes da conclusão.

Eventos de Reembolso

Nome do EventoTipo de EventoDescrição
Refund Succeededrefund.succeededAcionado quando um reembolso é processado com sucesso.
Refund Failedrefund.failedOcorre quando uma tentativa de reembolso falha devido a erros de processamento ou outros problemas.

Eventos de Disputa

Nome do EventoTipo de EventoDescrição
Dispute Openeddispute.openedAcionado quando um cliente inicia uma disputa.
Dispute Expireddispute.expiredIndica que uma disputa expirou sem resolução.
Dispute Accepteddispute.acceptedAcionado quando um comerciante aceita a disputa.
Dispute Cancelleddispute.cancelledOcorre quando uma disputa é cancelada pelo cliente ou pelo sistema.
Dispute Challengeddispute.challengedAcionado quando um comerciante contesta uma disputa.
Dispute Wondispute.wonIndica que o comerciante venceu com sucesso uma disputa.
Dispute Lostdispute.lostOcorre quando o comerciante perde uma disputa.

Eventos de Assinatura

Nome do EventoTipo de EventoDescrição
Subscription Activesubscription.activeIndica que uma assinatura está agora ativa e cobranças recorrentes estão agendadas.
Subscription Updatedsubscription.updatedAcionado quando qualquer campo de assinatura é atualizado (sincronização em tempo real sem polling).
Subscription On Holdsubscription.on_holdAcionado quando uma assinatura é temporariamente suspensa devido à falha na renovação.
Subscription Renewedsubscription.renewedOcorre quando uma assinatura é renovada com sucesso.
Subscription Plan Changedsubscription.plan_changedAcionado quando uma assinatura é atualizada, rebaixada ou modificada com addons diferentes.
Subscription Cancelledsubscription.cancelledAcionado quando uma assinatura é cancelada pelo comerciante ou cliente.
Subscription Failedsubscription.failedIndica uma assinatura falhada. Isso significa que não conseguimos criar um mandato.
Subscription Expiredsubscription.expiredAcionado quando uma assinatura chega ao fim do seu período e expira.

Eventos de Chave de Licença

Nome do EventoTipo de EventoDescrição
License Key Createdlicense_key.createdAcionado quando uma nova chave de licença é criada para um produto.

Eventos de Crédito

Event NameEvent TypeDescription
Credit Addedcredit.addedAcionado quando créditos são concedidos a um cliente (assinatura, uma única vez, complemento ou API).
Credit Deductedcredit.deductedOcorre quando créditos são consumidos por meio de uso ou débito manual.
Credit Expiredcredit.expiredAcionado quando créditos não utilizados expiram após o período de validade configurado.
Credit Rolled Overcredit.rolled_overOcorre quando créditos não utilizados são transferidos para uma nova concessão no fim do ciclo.
Rollover Forfeitedcredit.rollover_forfeitedAcionado quando os créditos são perdidos porque o número máximo de rollover foi atingido.
Overage Chargedcredit.overage_chargedOcorre quando cobranças por excedente são aplicadas devido ao uso além do saldo zero.
Manual Adjustmentcredit.manual_adjustmentAcionado quando é feita uma ajustar manual de crédito ou débito.
Balance Lowcredit.balance_lowAcionado quando o saldo de créditos cai abaixo do limite configurado.
Esses eventos de webhook foram projetados para fornecer aos comerciantes atualizações críticas para gerenciar suas operações de forma eficaz. Implemente tratadores robustos para cada evento relevante em sua integração de webhook para garantir funcionalidade suave e confiável.