Guía de Eventos de Webhook

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 evento	Tipo de evento	Descripción
Pago realizado con éxito	`payment.succeeded`	Se activa cuando un pago se procesa correctamente.
Pago fallido	`payment.failed`	Ocurre cuando un intento de pago falla debido a errores, tarjetas rechazadas u otros problemas.
Pago en proceso	`payment.processing`	Indica que un pago se está procesando actualmente.
Pago cancelado	`payment.cancelled`	Se activa cuando un pago se cancela antes de completarse.

Eventos de Reembolso

Nombre del evento	Tipo de evento	Descripción
Reembolso realizado con éxito	`refund.succeeded`	Se activa cuando un reembolso se procesa correctamente.
Reembolso fallido	`refund.failed`	Ocurre cuando un intento de reembolso falla debido a errores de procesamiento u otros problemas.

Eventos de Disputa

Nombre del evento	Tipo de evento	Descripción
Disputa abierta	`dispute.opened`	Se activa cuando un cliente inicia una disputa.
Disputa expirada	`dispute.expired`	Indica que una disputa expiró sin resolución.
Disputa aceptada	`dispute.accepted`	Se activa cuando un comerciante acepta la disputa.
Disputa cancelada	`dispute.cancelled`	Ocurre cuando el cliente o el sistema cancelan una disputa.
Disputa impugnada	`dispute.challenged`	Se activa cuando un comerciante impugna una disputa.
Disputa ganada	`dispute.won`	Indica que el comerciante ha ganado con éxito una disputa.
Disputa perdida	`dispute.lost`	Ocurre cuando el comerciante pierde una disputa.

Eventos de Suscripción

Nombre del evento	Tipo de evento	Descripción
Suscripción activa	`subscription.active`	Indica que una suscripción ahora está activa y que se han programado cargos recurrentes.
Suscripción actualizada	`subscription.updated`	Se activa cuando se actualiza cualquier campo de la suscripción (sincronización en tiempo real sin polling).
Suscripción en espera	`subscription.on_hold`	Se activa cuando una suscripción se pone temporalmente en espera debido a una renovación fallida.
Suscripción pausada	`subscription.paused`	Se activa cuando una suscripción se pausa.
Suscripción reanudada	`subscription.unpaused`	Se activa cuando se reanuda una suscripción pausada.
Suscripción renovada	`subscription.renewed`	Ocurre cuando una suscripción se renueva correctamente.
Plan de suscripción cambiado	`subscription.plan_changed`	Se activa cuando una suscripción se actualiza, degrada o modifica con diferentes complementos.
Método de pago de la suscripción actualizado	`subscription.update_payment_method`	Se envía cuando se actualiza el método de pago de una suscripción. Incluye la carga útil de la suscripción.
Suscripción cancelada	`subscription.cancelled`	Se activa cuando el comerciante o el cliente cancela una suscripción.
Suscripción fallida	`subscription.failed`	Indica que una suscripción ha fallado. Esto significa que no pudimos crear un mandato.
Suscripción expirada	`subscription.expired`	Se activa cuando una suscripción llega al final de su plazo y expira.

Eventos de Clave de Licencia

Nombre del evento	Tipo de evento	Descripción
Clave de licencia creada	`license_key.created`	Se activa cuando se crea una nueva clave de licencia para un producto.

Eventos de Concesión de Derechos

Nombre del Evento	Tipo de Evento	Descripción
Grant Created	`entitlement_grant.created`	Se crea una nueva concesión de derechos para un cliente. Las concesiones de clave de licencia llegan `delivered`; las concesiones basadas en OAuth (Discord, GitHub, Notion) llegan `pending`.
Grant Delivered	`entitlement_grant.delivered`	La entrega de la concesión se completa: se emite la clave de licencia, se resuelven los enlaces de archivo o se concede acceso a la plataforma.
Grant Failed	`entitlement_grant.failed`	Fallo en la entrega de la concesión; inspecciona `error_code` y `error_message`.
Grant Revoked	`entitlement_grant.revoked`	Se retira el acceso; inspecciona `revocation_reason` (estado de suscripción, reembolso, cambio de plan o manual).

Para esquemas de carga útil detallados, eventos de muestra y la referencia completa revocation_reason, consulta Entitlement Grant Webhooks.

Eventos de Crédito

Nombre del Evento	Tipo de Evento	Descripción
Crédito Añadido	`credit.added`	Se activa cuando se otorgan créditos a un cliente (suscripción, único, complemento o API).
Crédito Deducido	`credit.deducted`	Ocurre cuando se consumen créditos a través de uso o débito manual.
Crédito Expirado	`credit.expired`	Se activa cuando los créditos no utilizados expiran después del período de vencimiento configurado.
Crédito Acumulado	`credit.rolled_over`	Ocurre cuando créditos no utilizados se transfieren a un nuevo otorgamiento al final del ciclo.
Renuncia de Acumulación	`credit.rollover_forfeited`	Se activa cuando se pierden créditos porque se alcanzó el máximo de acumulación.
Cargo por Exceso	`credit.overage_charged`	Ocurre cuando se aplican cargos por exceso para uso más allá de saldo cero.
Reinicio de Exceso	`credit.overage_reset`	Se activa cuando se reinician los cargos acumulados por exceso (por ejemplo, al inicio de un nuevo ciclo de facturación).
Ajuste Manual	`credit.manual_adjustment`	Se activa cuando se realiza un ajuste manual de crédito o débito.
Saldo Bajo	`credit.balance_low`	Se activa cuando el saldo de crédito cae por debajo del umbral configurado.

Eventos de Recuperación

Nombre del Evento	Tipo de Evento	Descripción
Abandoned Checkout Detected	`abandoned_checkout.detected`	Se activa cuando se detecta un checkout incompleto o fallido después de 60 minutos.
Abandoned Checkout Recovered	`abandoned_checkout.recovered`	Ocurre cuando un cliente completa el pago a través de un enlace de recuperación.

Para esquemas de carga útil detallados, descripciones de campos y ejemplos de controladores, consulta Webhooks de Recuperación.

Eventos de Cobro de Morosidad

Nombre del Evento	Tipo de Evento	Descripción
Dunning Started	`dunning.started`	Se activa cuando comienza un intento de cobro de morosidad para una suscripción que estuvo en espera o fue cancelada.
Dunning Recovered	`dunning.recovered`	Ocurre cuando un cliente actualiza su método de pago y el cargo resultante tiene éxito.

Para esquemas de carga útil detallados, descripciones de campos y ejemplos de controladores, consulta Recovery Webhooks.

Eventos de pagos

Estos eventos hacen un seguimiento del movimiento de tus fondos desde Dodo Payments hasta tu cuenta bancaria y reflejan los estados de los pagos que se muestran en el panel. La carga útil es un objeto de pago con la misma estructura que una entrada de GET /payouts.

Nombre del evento	Tipo de evento	Descripción
Pago creado	`payout.created`	Se activa cuando se crea un pago, ya sea mediante el ciclo de pagos automático o fuera de ciclo.
Pago en proceso	`payout.in_progress`	Ocurre cuando llega la fecha de vencimiento del pago y este comienza a procesarse.
Pago en espera	`payout.on_hold`	Se activa cuando un pago se pausa o se somete a revisión.
Pago realizado correctamente	`payout.success`	Ocurre cuando el pago a tu cuenta bancaria se procesa correctamente.
Pago fallido	`payout.failed`	Se activa cuando falla un pago. Los fondos y las comisiones se abonan nuevamente en tu saldo.

No asumas que los eventos de pagos son terminales o que siguen un orden estricto. payout.failed puede llegar legítimamente después de payout.success cuando un banco devuelve la transferencia, y payout.success puede llegar después de payout.failed cuando posteriormente se recupera un pago fallido. Trata siempre el estado de la carga útil como el estado actual.

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

Para consultar esquemas detallados de la carga útil, descripciones de campos y ejemplos de handlers, consulta Payout Webhooks. Estos eventos de webhook están diseñados para proporcionar a los comerciantes actualizaciones esenciales que les permitan gestionar sus operaciones de manera eficaz. Implementa handlers sólidos para cada evento relevante en tu integración de webhook a fin de garantizar un funcionamiento fluido y confiable.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Eventos de Pago

Eventos de Reembolso

Eventos de Disputa

Eventos de Suscripción

Eventos de Clave de Licencia

Eventos de Concesión de Derechos

Eventos de Crédito

Eventos de Recuperación

Eventos de Cobro de Morosidad

Eventos de pagos

​Eventos de Pago

​Eventos de Reembolso

​Eventos de Disputa

​Eventos de Suscripción

​Eventos de Clave de Licencia

​Eventos de Concesión de Derechos

​Eventos de Crédito

​Eventos de Recuperación

​Eventos de Cobro de Morosidad

​Eventos de pagos

Eventos de Pago

Eventos de Reembolso

Eventos de Disputa

Eventos de Suscripción

Eventos de Clave de Licencia

Eventos de Concesión de Derechos

Eventos de Crédito

Eventos de Recuperación

Eventos de Cobro de Morosidad

Eventos de pagos