Guía de eventos de Webhook

Dodo Payments emite eventos de webhook en cada etapa del ciclo de vida de un pago, una suscripción, una disputa, un payout, un crédito o una clave de licencia. Esta página enumera todos los eventos por recurso. Para consultar esquemas detallados del payload y ejemplos de handlers, consulta las páginas específicas de cada recurso enlazadas a continuación.

Eventos de pago

Evento	Se activa cuando
`payment.succeeded`	Un pago se procesa correctamente.
`payment.failed`	Un intento de pago falla debido a tarjetas rechazadas, fondos insuficientes u otros errores.
`payment.processing`	Un pago está en proceso.
`payment.cancelled`	Un pago se cancela antes de completarse.

Para consultar el esquema completo del payload, consulta Webhooks de pagos.

Eventos de reembolso

Evento	Se activa cuando
`refund.succeeded`	Un reembolso se procesa correctamente.
`refund.failed`	Un intento de reembolso falla debido a errores de procesamiento u otros problemas.

Para consultar el esquema completo del payload, consulta Webhooks de reembolsos.

Eventos de disputas

Evento	Se activa cuando
`dispute.opened`	El titular de una tarjeta abre una disputa sobre un pago.
`dispute.challenged`	Se han enviado pruebas para impugnar la disputa.
`dispute.accepted`	La disputa se aceptó sin ser impugnada.
`dispute.cancelled`	La disputa se retiró o canceló.
`dispute.expired`	El plazo de respuesta transcurrió sin resolución.
`dispute.won`	La disputa se resolvió a tu favor.
`dispute.lost`	La disputa se resolvió a favor del titular de la tarjeta.

Para consultar esquemas detallados del payload y ejemplos de handlers, consulta Webhooks de disputas.

Eventos de suscripción

Evento	Se activa cuando
`subscription.active`	Una suscripción se activa correctamente y se programan los cargos recurrentes.
`subscription.updated`	Cambia cualquier campo de la suscripción (sincronización en tiempo real sin polling).
`subscription.past_due`	Una renovación falla y comienza el período de gracia; el cliente conserva el acceso hasta la fecha límite.
`subscription.on_hold`	Una suscripción se pone temporalmente en espera debido a un fallo en la renovación.
`subscription.paused`	Una suscripción se pausa.
`subscription.unpaused`	Una suscripción pausada se reanuda.
`subscription.renewed`	Una suscripción se renueva correctamente para el siguiente período de facturación.
`subscription.plan_changed`	Una suscripción se actualiza, se cambia a un plan inferior o se modifica con add-ons diferentes.
`subscription.update_payment_method`	Se actualiza el método de pago de una suscripción.
`subscription.cancelled`	El merchant o el cliente cancela una suscripción.
`subscription.failed`	La creación de una suscripción falla durante la creación del mandato.
`subscription.expired`	Una suscripción llega al final de su plazo y expira.

Para consultar esquemas detallados del payload y ejemplos de handlers, consulta Webhooks de suscripciones.

Eventos de claves de licencia

Evento	Se activa cuando
`license_key.created`	Se crea una nueva clave de licencia para un producto.

Para consultar el esquema completo del payload, consulta Webhooks de claves de licencia.

Eventos de concesión de derechos

Evento	Se activa cuando
`entitlement_grant.created`	Se crea una nueva concesión de derechos para un cliente. Las concesiones de claves de licencia autocompletadas y las concesiones de feature flags llegan con `status: "Delivered"` y no activan ningún evento `delivered` independiente. Otras concesiones, incluidas las claves de licencia completadas manualmente, llegan `Pending`. Consulta Concesión de derechos.
`entitlement_grant.delivered`	Se completa el fulfillment de la concesión: se emite la clave de licencia, se resuelven los enlaces a archivos o se concede el acceso a la plataforma.
`entitlement_grant.failed`	El fulfillment de la concesión falla. Comprueba `error_code` y `error_message` en el payload.
`entitlement_grant.revoked`	Se retira el acceso. Comprueba `revocation_reason` en el payload.

Para consultar esquemas detallados del payload, eventos de ejemplo y la referencia completa de revocation_reason, consulta Webhooks de concesiones de derechos.

Eventos de créditos

Evento	Se activa cuando
`credit.added`	Se conceden créditos a un cliente (mediante una suscripción, una compra única, un add-on o la API).
`credit.deducted`	Se consumen créditos mediante uso o débito manual.
`credit.expired`	Los créditos no utilizados expiran después del período de expiración configurado.
`credit.rolled_over`	Los créditos no utilizados se transfieren a una nueva concesión al final del ciclo.
`credit.rollover_forfeited`	Los créditos se pierden porque se alcanzó el número máximo de rollovers.
`credit.overage_charged`	Se aplican cargos por exceso al superar el saldo cero.
`credit.overage_reset`	Se restablecen los cargos por exceso acumulados (por ejemplo, al inicio de un nuevo ciclo de facturación).
`credit.manual_adjustment`	Se realiza un ajuste manual de crédito o débito.
`credit.balance_low`	El saldo de créditos cae por debajo del umbral configurado.

Para consultar esquemas detallados del payload y ejemplos de handlers, consulta Webhooks de facturación basada en créditos.

Eventos de recuperación

Evento	Se activa cuando
`abandoned_checkout.detected`	Se detecta un checkout incompleto o fallido después de 60 minutos.
`abandoned_checkout.recovered`	Un cliente completa el pago mediante un enlace de recuperación.

Para consultar esquemas detallados del payload, descripciones de campos y ejemplos de handlers, consulta Webhooks de recuperación.

Eventos de dunning

Evento	Se activa cuando
`dunning.started`	Comienza un intento de dunning para una suscripción cuyo pago está vencido o en espera, o que fue cancelada.
`dunning.recovered`	Un cliente actualiza su método de pago y el cargo resultante se procesa correctamente.

Para consultar esquemas detallados del payload, descripciones de campos y ejemplos de handlers, consulta Webhooks de recuperación.

Eventos de payout

Los eventos de payout registran el movimiento de tus fondos desde Dodo Payments hasta tu cuenta bancaria. Reflejan los estados de payout que se muestran en el dashboard. El payload es un objeto de payout con la misma estructura que una entrada de GET /payouts.

Evento	Se activa cuando
`payout.created`	Se crea un payout, ya sea mediante el ciclo automático de payouts o fuera de ciclo.
`payout.in_progress`	Llega la fecha de vencimiento del payout y comienza el procesamiento.
`payout.on_hold`	Un payout se pausa o se somete a revisión.
`payout.success`	El payout a tu cuenta bancaria se liquida.
`payout.failed`	Un payout falla. Los fondos y las comisiones se abonan nuevamente en tu wallet.

Los eventos de payout no son terminales ni siguen un orden estricto. payout.failed puede llegar después de payout.success cuando un banco devuelve la transferencia, y payout.success puede llegar después de payout.failed cuando un payout fallido se recupera posteriormente. El status del payload siempre coincide con el tipo de evento, por lo que debes usar el timestamp de nivel superior de cada evento para encontrar el estado más reciente.

payout.created se emitía anteriormente como payout.not_initiated. Si un endpoint existente filtra por payout.not_initiated, actualiza el filtro a payout.created para que siga coincidiendo.

Para consultar esquemas detallados del payload, descripciones de campos y ejemplos de handlers, consulta Webhooks de payouts.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Eventos de pago

Eventos de reembolso

Eventos de disputas

Eventos de suscripción

Eventos de claves de licencia

Eventos de concesión de derechos

Eventos de créditos

Eventos de recuperación

Eventos de dunning

Eventos de payout

​Eventos de pago

​Eventos de reembolso

​Eventos de disputas

​Eventos de suscripción

​Eventos de claves de licencia

​Eventos de concesión de derechos

​Eventos de créditos

​Eventos de recuperación

​Eventos de dunning

​Eventos de payout

Eventos de pago

Eventos de reembolso

Eventos de disputas

Eventos de suscripción

Eventos de claves de licencia

Eventos de concesión de derechos

Eventos de créditos

Eventos de recuperación

Eventos de dunning

Eventos de payout