Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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 está activa y 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 sondeo). |
| 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 renovada | subscription.renewed | Ocurre cuando una suscripción se renueva con éxito. |
| Plan de suscripción cambiado | subscription.plan_changed | Se activa cuando una suscripción se actualiza a una versión superior, inferior o se modifica con complementos distintos. |
| Suscripción cancelada | subscription.cancelled | Se activa cuando el comerciante o el cliente cancelan una suscripción. |
| Suscripción fallida | subscription.failed | Indica una suscripción fallida. Esto significa que no pudimos crear un mandato. |
| Suscripción expirada | subscription.expired | Se activa cuando una suscripción alcanza el final de su período 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). |
revocation_reason, consulta Entitlement Grant Webhooks.
Eventos de Crédito
| Nombre del Evento | Tipo de Evento | Descripción |
|---|
| Credit Added | credit.added | Se activa cuando se conceden créditos a un cliente (suscripción, única vez, complemento o API). |
| Credit Deducted | credit.deducted | Ocurre cuando los créditos se consumen a través de uso o débito manual. |
| Credit Expired | credit.expired | Se activa cuando los créditos no utilizados expiran después del período de caducidad configurado. |
| Credit Rolled Over | credit.rolled_over | Ocurre cuando los créditos no utilizados se transfieren a una nueva concesión al final del ciclo. |
| Rollover Forfeited | credit.rollover_forfeited | Se activa cuando se pierden créditos porque se alcanzó el conteo máximo de transferencias. |
| Overage Charged | credit.overage_charged | Ocurre cuando se aplican cargos por exceso de uso más allá del saldo cero. |
| Manual Adjustment | credit.manual_adjustment | Se activa cuando se realiza una ajuste manual de crédito o débito. |
| Balance Low | 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. |
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. |
