Introduzione

​

Cosa sono gli entitlement?

​

Integrazioni Disponibili

​

Come funzionano le concessioni

​

Ciclo di vita delle concessioni

​

Comportamento dei grant in base all’evento

​

Crea il tuo primo entitlement

1

Open Entitlements

Vai alla sezione Entitlements nella dashboard e fai clic su + per creare un entitlement.

2

Pick an Integration

Scegli il tipo di integrazione: License Key, Digital Files, Feature Flag, Discord, GitHub, Telegram, Figma, Framer o Notion. Per un’integrazione di piattaforma, collega prima il tuo account se non l’hai già fatto.

3

Configure Delivery

Compila i campi dell’integrazione. Ad esempio, GitHub richiede un repository e un livello di autorizzazione, Discord richiede un server e un ruolo opzionale, mentre License Key richiede un limite di attivazioni e una durata della licenza.

4

Save

Fai clic su Create Entitlement. Ora puoi collegare l’entitlement a qualsiasi prodotto.

​

Collega gli entitlement ai prodotti

​

Esperienza del cliente

​

E-mail e Customer Portal

​

Consegna basata su OAuth

​

Revoca

​

Gestisci i grant

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")

​

Gestione tramite API

​

Webhook

​

Best practice

• Usa un entitlement per ogni canale di consegna. Non condividere un entitlement Discord tra prodotti con ruoli diversi. Crea un entitlement per ogni ruolo, così la revoca rimane pulita.
• Esegui prima i test in modalità test. Crea l’entitlement, collegalo a un prodotto di test, esegui un checkout e osserva il grant passare da Pending a Delivered. Poi cancella l’abbonamento di test e verifica che il grant venga revocato.
• Ascolta entitlement_grant.delivered, non payment.succeeded. Un pagamento può avere esito positivo prima che il fulfillment sia completato, soprattutto nei flussi OAuth. Attendi che il grant raggiunga Delivered prima di sbloccare le funzionalità dipendenti nei tuoi sistemi. Un grant consegnato alla creazione, come una chiave di licenza completata automaticamente o un feature flag, arriva come entitlement_grant.created con status: "Delivered".
• Considera entitlement_grant.failed un evento che richiede un’azione. Un grant fallito significa che un cliente ha pagato ma non ha ottenuto l’accesso. Segnala questi grant al team di supporto o attiva una nuova emissione.
• Collega revocation_reason ai tuoi flussi di fidelizzazione. Una revoca subscription_on_hold è recuperabile, perché il cliente potrebbe aggiornare la propria carta. Una revoca manual è intenzionale. Gestiscile in modo diverso nei messaggi ai clienti.
• Non revocare l’accesso su subscription.past_due. Questo evento apre un periodo di tolleranza e il cliente mantiene l’accesso fino alla fine della finestra. Attendi subscription.on_hold o subscription.cancelled.