Notion Entitlement

​

Cosa viene fornito

• Il cliente connette la propria area di lavoro Notion dal Customer Portal. L’email di conferma del pagamento indica l’entitlement come Action Required e include un link al portale.
• Dopo l’autorizzazione, Dodo Payments copia il template configurato in una pagina condivisa dal cliente durante l’autorizzazione, nell’area di lavoro scelta.
• Quando il grant viene revocato, la copia rimane nell’area di lavoro del cliente. Dodo Payments contrassegna il grant come Revoked per la conservazione dei dati e non elimina la copia.

​

Connetti Notion

1

Open Entitlements

Nel dashboard di Dodo Payments, vai a Entitlements e fai clic su +.

2

Pick Notion

Scegli Notion Template come integrazione. Se Notion non è ancora connesso, fai clic su Connect Notion.

Notion si apre in una nuova scheda. Accedi all’area di lavoro che contiene i tuoi template sorgente e verifica le autorizzazioni richieste da Dodo Payments. Quindi seleziona le pagine (template) che l’integrazione può leggere e copiare.

Quando Notion reindirizza alla pagina precedente, una pagina di conferma mostra che l’area di lavoro è connessa.

3

Pick a Template

Tornato nel dashboard, seleziona il template da copiare in Template. Qui vengono mostrate solo le pagine condivise nel passaggio precedente. Inserisci un Name per l’entitlement e fai clic su Create Entitlement.

4

Attach It to a Product

Associa l’entitlement a qualsiasi prodotto. Consulta Associare gli entitlement ai prodotti.

​

Flusso del cliente

1. Il cliente completa il checkout.
2. Dodo Payments crea un grant con stato Pending. Dodo Payments prova a creare subito un URL di autorizzazione Notion e lo memorizza in oauth_url. Se l’operazione non riesce, oauth_url rimane null finché il cliente non avvia il flusso di accettazione.
3. Nel Customer Portal, il cliente fa clic su Connetti nell’entitlement, esegue l’autorizzazione con Notion, sceglie lo spazio di lavoro in cui ricevere il template e condivide almeno una pagina con Dodo Payments.
4. Dodo Payments copia il template in una pagina condivisa di quello spazio di lavoro. Il grant passa a Delivered.
5. In caso di revoca, il grant viene contrassegnato come Revoked e la copia rimane nello spazio di lavoro del cliente.

​

Configurazione richiesta

​

Creazione tramite API

import DodoPayments from 'dodopayments';

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

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: '3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c',
  },
});

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

entitlement = client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"},
)

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Study Notes"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigNotionConfigParam{
      NotionTemplateID: dodopayments.F("3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"),
    },
  ),
})

​

Webhook

• entitlement_grant.created viene attivato con status: "Pending". oauth_url potrebbe contenere già l’URL di autorizzazione Notion. Se è null, viene valorizzato quando il cliente avvia il flusso di accettazione dal Customer Portal.
• entitlement_grant.delivered viene attivato quando il template è stato copiato.
• entitlement_grant.revoked viene attivato in caso di annullamento. La copia del cliente non viene modificata.

​

Risoluzione dei problemi