Entregue automáticamente claves de licencia, archivos descargables, feature flags y acceso a plataformas como Discord, GitHub, Telegram, Framer y Notion cuando los clientes paguen.
Las autorizaciones convierten un pago exitoso o una suscripción activa en acceso real: una clave de licencia en la bandeja de entrada de tu cliente, un feature flag que tu aplicación verifica, un rol en Discord, un repositorio de GitHub, una plantilla de Notion, un enlace de remix de Framer, una invitación al chat de Telegram o un paquete de archivos descargables. Dodo Payments emite, rastrea y revoca ese acceso automáticamente a medida que el ciclo de vida del pago cambia.
The Entitlements dashboard. Each entitlement is a reusable template; the right pane shows individual customer grants.
Un entitlement es una definición reutilizable de algo que entregas a un cliente: una clave de licencia Pro, un rol de Discord de “Patrons”, acceso a tu repositorio privado en GitHub, un paquete de libros electrónicos descargables. Adjuntas entitlements a productos, y Dodo Payments se encarga del resto.Cuando un cliente compra el producto, Dodo Payments crea una concesión, una emisión individual de ese entitlement para el cliente. Las concesiones pasan por un pequeño conjunto de estados: pending mientras la entrega está en progreso, delivered una vez que el cliente tiene acceso, failed si la entrega no se pudo completar, e revoked cuando el acceso es retirado.
Las Entitlements regulan el cumplimiento (¿tiene acceso el cliente?). Los créditos regulan el consumo (¿cuánto pueden usar?). Ambos se pueden adjuntar al mismo producto. Ver Facturación Basada en Créditos para créditos.
Las autorizaciones son impulsadas por los mismos eventos de pago y suscripción que ya recibes como webhooks. No necesitas llamar a la API de autorización para las compras. Dodo Payments crea y revoca autorizaciones automáticamente basándose en el ciclo de vida de pago subyacente.
Se crea una autorización cuando se completa un pago o una suscripción se activa. Las claves de licencia y los feature flags pasan directamente a delivered. Toda otra integración comienza en pending. Las integraciones basadas en OAuth (Discord, GitHub, Notion) incluyen un oauth_url que el cliente debe visitar para completar el consentimiento. Las integraciones directas de plataforma (Telegram, Framer, Archivos Digitales) están en pending brevemente mientras se provisiona la entrega, luego transicionan a delivered.
2
Delivered
Una vez completada la entrega (clave de licencia generada, rol asignado, acceso al repositorio otorgado, enlaces de archivos resueltos, OAuth completado), la autorización pasa a delivered y se establece delivered_at.
3
Failed
Si la llamada a la integración devuelve un error no reintentable (token de OAuth revocado, permiso denegado, archivo que ya no existe), la autorización pasa a failed. Los campos error_code e error_message capturan la razón.
4
Revoked
Cuando se retira el acceso (suscripción cancelada, reembolso emitido o revocación iniciada por el comerciante), la autorización pasa a revoked. El campo revocation_reason registra el desencadenante.
Sin acción. Las autorizaciones son impulsadas por el evento de suscripción a continuación.
subscription.active
Emitir autorizaciones para cualquier derecho adjunto que aún no tenga uno. Reevaluar cualquier autorización previamente revocada para la misma suscripción.
subscription.renewed
Sin acción. Las autorizaciones existentes persisten a través de renovaciones.
subscription.on_hold
Revocar todas las autorizaciones entregadas y pendientes. revocation_reason: subscription_on_hold.
Revocar todas las autorizaciones actuales, luego emitir autorizaciones para los derechos del nuevo plan. revocation_reason: plan_changed.
refund.succeeded (pago único)
Revocar autorizaciones para ese pago. revocation_reason: refund.
Revocación manual de API
Revocar con revocation_reason: manual. Las revocaciones manuales no se reanudan automáticamente en la renovación de la suscripción.
Licencia deshabilitada
Para autorizaciones de clave de licencia, deshabilitar la clave subyacente revoca la autorización con revocation_reason: license_key_disabled. La autorización se reactiva automáticamente si la clave se vuelve a habilitar.
Desajuste de plataforma detectado
Si el lado de la integración de la plataforma se desincroniza (un rol de Discord eliminado manualmente, el App de GitHub perdiendo acceso al repositorio o un pase de reconciliación detectando un objetivo perdido), la autorización se revoca con revocation_reason: platform_external. No se reanuda automáticamente en la renovación de la suscripción hasta que se resuelva el problema subyacente de la plataforma.
Las autorizaciones impulsadas por suscripción son idempotentes por (entitlement, customer, subscription); las renovaciones y reactivaciones no crean autorizaciones duplicadas. Las autorizaciones de una sola vez son idempotentes por (entitlement, customer, payment).
Dirígete a Entitlements en tu panel de Dodo Payments y haz clic en + para crear un nuevo derecho.
2
Pick an integration
Elige el tipo de integración: Clave de Licencia, Archivos Digitales, Feature Flag, Discord, GitHub, Telegram, Framer o Notion. Para integraciones de plataforma, conecta tu cuenta primero si aún no lo has hecho.
3
Configure delivery
Completa los campos específicos de la integración. Por ejemplo, GitHub pide un repositorio y un nivel de permiso; Discord pide un servidor y un rol opcional; Clave de Licencia pide límites de activación y caducidad.
Creating a GitHub entitlement. Each integration shows the fields it needs.
4
Save
Guarda el derecho. Ahora puedes adjuntarlo a cualquier producto.
Abre un producto, expande Configuración Avanzada → Derechos y Créditos, y selecciona los derechos que se deben entregar cuando se compra el producto. Un solo producto puede entregar múltiples derechos a la vez. Por ejemplo, un plan Pro puede incluir una clave de licencia, acceso a GitHub y un rol de Discord.
Attaching entitlements to a product. Selected entitlements are delivered on every successful purchase or active subscription.
Los clientes reciben un correo de entrega después de la compra que contiene la clave de licencia, enlaces de descarga, enlaces de invitación OAuth o invitación de plataforma, lo que aplique a los derechos en el producto. Los mismos detalles permanecen disponibles indefinidamente en el Portal del Cliente bajo su historial de pedidos.
El acceso del suscriptor de Discord, GitHub y Notion requiere que el cliente autorice a Dodo Payments para otorgarle acceso. Estas autorizaciones permanecen en estado pending hasta que el cliente complete el flujo OAuth usando el enlace de su correo electrónico o portal de cliente. Una vez que autorizan, la autorización pasa a delivered y el acceso a la plataforma se provisiona inmediatamente.
Las autorizaciones revocadas se eliminan a nivel de plataforma: se elimina el rol de Discord, se elimina el colaborador de GitHub, se desactiva la clave de licencia. Los clientes ven el cambio reflejado en el portal del cliente.
Para Archivos Digitales, la revocación elimina el acceso a las URL pre-firmadas en adelante pero no invalida las copias que un cliente ya ha descargado. Planifica el contenido del plan en consecuencia.
Abre cualquier derecho desde el panel para ver sus autorizaciones. El panel de detalle de autorización muestra autorizaciones totales, filtros de estado, información del cliente, fechas de entrega y una acción de revocación.También puedes gestionar autorizaciones de forma programática:
import DodoPayments from 'dodopayments';const client = new DodoPayments({ bearerToken: process.env['DODO_PAYMENTS_API_KEY'],});// List grants for an entitlementconst grants = await client.entitlements.grants.list('ent_abc123', { status: 'Delivered',});// Revoke a single grantawait client.entitlements.grants.revoke('grant_xyz789', { id: 'ent_abc123',});
Dodo Payments dispara cuatro eventos de webhook para el ciclo de vida de la autorización. Suscríbete a estos eventos para mantener tu aplicación sincronizada con lo que cada cliente puede acceder.
Evento
Se activa cuando
entitlement_grant.created
Se crea una nueva autorización. Las autorizaciones de clave de licencia llegan delivered; cada otra integración llega pending y transiciona a delivered una vez que la llamada a la plataforma tiene éxito (o, para las integraciones basadas en OAuth, una vez que el cliente autoriza).
entitlement_grant.delivered
La autorización transiciona a entregada. El cliente ahora tiene acceso.
entitlement_grant.failed
No se pudo entregar la autorización. Inspecciona error_code e error_message.
entitlement_grant.revoked
Se ha retirado el acceso. Inspecciona revocation_reason.
Entitlement Grant Webhook Payloads
Visualiza el esquema completo de carga útil, eventos de muestra y referencia revocation_reason.
Usa un derecho por canal de entrega. No compartas un solo derecho de Discord entre productos con intenciones de rol diferentes; crea uno por rol para una revocación limpia.
Prueba primero en modo de prueba. Crea el derecho, adjúntalo a un producto de prueba, realiza una compra y observa la transición de la autorización a través de pending → delivered. Confirma que cancelar la suscripción de prueba revoca la autorización.
Escucha entitlement_grant.delivered, no payment.succeeded. Un pago puede tener éxito antes de que se complete el cumplimiento (especialmente para flujos de OAuth). Espera el evento entregado antes de desbloquear funciones dependientes en tus propios sistemas.
Trata entitlement_grant.failed como accionable. Una autorización fallida significa que un cliente pagó pero no obtuvo acceso. Muestra estos a tu equipo de soporte o activa una nueva concesión.
Mapea revocation_reason a tus flujos de retención. Una revocación subscription_on_hold es recuperable (el cliente puede actualizar su tarjeta). Una revocación manual es intencional. Trátalos de manera diferente en las comunicaciones con el cliente.
