Introducción

​

¿Qué son los entitlements?

​

Integraciones Disponibles

​

Cómo funcionan las autorizaciones

​

Ciclo de vida de la autorización

​

Comportamiento de los grants según el evento

​

Crea tu primer entitlement

1

Open Entitlements

Ve a Entitlements en el dashboard y haz clic en + para crear un entitlement.

2

Pick an Integration

Elige el tipo de integración: License Key, Digital Files, Feature Flag, Discord, GitHub, Telegram, Figma, Framer o Notion. Para una integración de plataforma, conecta primero tu cuenta si aún no lo has hecho.

3

Configure Delivery

Completa los campos de la integración. Por ejemplo, GitHub solicita un repositorio y un nivel de permisos; Discord solicita un servidor y un rol opcional; y License Key solicita un límite de activaciones y una duración de la licencia.

4

Save

Haz clic en Create Entitlement. Ahora puedes asociar el entitlement a cualquier producto.

​

Asocia entitlements a productos

​

Experiencia del cliente

​

Correo electrónico y Customer Portal

​

Entrega basada en OAuth

​

Revocación

​

Gestiona grants

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

// List grants for an entitlement
const grants = await client.entitlements.grants.list('ent_abc123', {
  status: 'Delivered',
});

// Revoke a single grant
await client.entitlements.grants.revoke('entg_xyz789', {
  id: 'ent_abc123',
});

# Assumes client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])
grants = client.entitlements.grants.list(
    "ent_abc123",
    status="Delivered",
)

client.entitlements.grants.revoke(
    "entg_xyz789",
    id="ent_abc123",
)

// Assumes client := dodopayments.NewClient() and ctx := context.Background().
grants, err := client.Entitlements.Grants.List(
  ctx, "ent_abc123",
  dodopayments.EntitlementGrantListParams{
    Status: dodopayments.F(dodopayments.EntitlementGrantListParamsStatusDelivered),
  },
)
if err != nil {
  panic(err.Error())
}
fmt.Println(len(grants.Items))

_, err = client.Entitlements.Grants.Revoke(ctx, "ent_abc123", "entg_xyz789")

​

Gestión mediante la API

​

Webhooks

​

Prácticas recomendadas

• Usa un entitlement por canal de entrega. No compartas un entitlement de Discord entre productos con distintas funciones de rol. Crea un entitlement por rol para que la revocación sea clara.
• Prueba primero en modo de prueba. Crea el entitlement, asígnalo a un producto de prueba, realiza un checkout y observa cómo el grant pasa de Pending a Delivered. Después, cancela la suscripción de prueba y confirma que el grant se revoca.
• Escucha entitlement_grant.delivered, no payment.succeeded. Un pago puede completarse antes de que finalice el fulfillment, especialmente en los flujos de OAuth. Espera a que el grant alcance Delivered antes de desbloquear funciones dependientes en tus propios sistemas. Un grant que se entrega al crearse, como una clave de licencia completada automáticamente o un feature flag, llega como entitlement_grant.created con status: "Delivered".
• Trata entitlement_grant.failed como una acción necesaria. Un grant fallido significa que un cliente pagó pero no obtuvo acceso. Muestra estos grants a tu equipo de soporte o activa una nueva emisión.
• Asocia revocation_reason a tus flujos de retención. Una revocación subscription_on_hold se puede recuperar porque el cliente podría actualizar su tarjeta. Una revocación manual es intencionada. Trátalas de forma distinta en los mensajes a los clientes.
• No revoques el acceso en subscription.past_due. Ese evento abre un periodo de gracia y el cliente conserva el acceso hasta que finaliza la ventana. Espera a subscription.on_hold o subscription.cancelled.