Saltar al contenido principal
Dodo Payments proporciona notificaciones de webhook en tiempo real para mantenerte informado sobre eventos críticos relacionados con transacciones, suscripciones, reembolsos, disputas y gestión de claves de licencia. A continuación, se presenta una guía detallada de estos eventos, categorizados para mayor claridad, junto con consejos y consideraciones de implementación.

Eventos de Pago

Nombre del eventoTipo de eventoDescripción
Pago realizado con éxitopayment.succeededSe activa cuando un pago se procesa correctamente.
Pago fallidopayment.failedOcurre cuando un intento de pago falla debido a errores, tarjetas rechazadas u otros problemas.
Pago en procesopayment.processingIndica que un pago se está procesando actualmente.
Pago canceladopayment.cancelledSe activa cuando un pago se cancela antes de completarse.

Eventos de Reembolso

Nombre del eventoTipo de eventoDescripción
Reembolso realizado con éxitorefund.succeededSe activa cuando un reembolso se procesa correctamente.
Reembolso fallidorefund.failedOcurre cuando un intento de reembolso falla debido a errores de procesamiento u otros problemas.

Eventos de Disputa

Nombre del eventoTipo de eventoDescripción
Disputa abiertadispute.openedSe activa cuando un cliente inicia una disputa.
Disputa expiradadispute.expiredIndica que una disputa expiró sin resolución.
Disputa aceptadadispute.acceptedSe activa cuando un comerciante acepta la disputa.
Disputa canceladadispute.cancelledOcurre cuando el cliente o el sistema cancelan una disputa.
Disputa impugnadadispute.challengedSe activa cuando un comerciante impugna una disputa.
Disputa ganadadispute.wonIndica que el comerciante ha ganado con éxito una disputa.
Disputa perdidadispute.lostOcurre cuando el comerciante pierde una disputa.

Eventos de Suscripción

Nombre del eventoTipo de eventoDescripción
Suscripción activasubscription.activeIndica que una suscripción está activa y se han programado cargos recurrentes.
Suscripción actualizadasubscription.updatedSe activa cuando se actualiza cualquier campo de la suscripción (sincronización en tiempo real sin sondeo).
Suscripción en esperasubscription.on_holdSe activa cuando una suscripción se pone temporalmente en espera debido a una renovación fallida.
Suscripción renovadasubscription.renewedOcurre cuando una suscripción se renueva con éxito.
Plan de suscripción cambiadosubscription.plan_changedSe activa cuando una suscripción se actualiza a una versión superior, inferior o se modifica con complementos distintos.
Suscripción canceladasubscription.cancelledSe activa cuando el comerciante o el cliente cancelan una suscripción.
Suscripción fallidasubscription.failedIndica una suscripción fallida. Esto significa que no pudimos crear un mandato.
Suscripción expiradasubscription.expiredSe activa cuando una suscripción alcanza el final de su período y expira.

Eventos de Clave de Licencia

Nombre del eventoTipo de eventoDescripción
Clave de licencia creadalicense_key.createdSe activa cuando se crea una nueva clave de licencia para un producto.

Eventos de crédito

Nombre del eventoTipo de eventoDescripción
Crédito añadidocredit.addedSe activa cuando se otorgan créditos a un cliente (suscripción, compra única, complemento o API).
Crédito deducidocredit.deductedOcurre cuando los créditos se consumen mediante uso o débito manual.
Crédito caducadocredit.expiredSe activa cuando los créditos no utilizados caducan tras el período de expiración configurado.
Crédito transferidocredit.rolled_overOcurre cuando los créditos no utilizados se trasladan a una nueva asignación al final del ciclo.
Transferencia perdidacredit.rollover_forfeitedSe activa cuando los créditos se pierden porque se alcanzó el número máximo de transferencias.
Sobrecargo aplicadocredit.overage_chargedOcurre cuando se aplican cargos por uso excesivo más allá del saldo cero.
Ajuste manualcredit.manual_adjustmentSe activa cuando se realiza un ajuste manual de crédito o débito.
Saldo bajocredit.balance_lowSe activa cuando el saldo de créditos cae por debajo del umbral configurado.
Estos eventos de webhook están diseñados para proporcionar a los comerciantes actualizaciones críticas que les permitan gestionar sus operaciones de manera eficaz. Implemente controladores robustos para cada evento relevante en su integración de webhook para garantizar una funcionalidad fluida y fiable.