Droit d'utilisation Notion

​

Éléments livrés

• Le client connecte son espace de travail Notion depuis le Customer Portal. L’e-mail de confirmation du paiement indique que l’entitlement Action Required et contient un lien vers le portail.
• Après son autorisation, Dodo Payments copie le modèle configuré dans une page que le client a partagée pendant l’autorisation, au sein de l’espace de travail choisi.
• Lorsque l’octroi est révoqué, la copie reste dans l’espace de travail du client. Dodo Payments marque l’octroi Revoked à des fins d’archivage et ne supprime pas la copie.

​

Connecter Notion

1

Open Entitlements

Dans le tableau de bord Dodo Payments, accédez à Entitlements et cliquez sur +.

2

Pick Notion

Choisissez Notion Template comme intégration. Si Notion n’est pas encore connecté, cliquez sur Connect Notion.

Notion s’ouvre dans un nouvel onglet. Connectez-vous à l’espace de travail qui possède vos modèles sources et examinez les autorisations demandées par Dodo Payments. Sélectionnez ensuite les pages (modèles) que l’intégration peut lire et copier.

Lorsque Notion vous redirige, une page de confirmation indique que l’espace de travail est connecté.

3

Pick a Template

De retour dans le tableau de bord, sélectionnez sous Template le modèle à copier. Seules les pages que vous avez partagées à l’étape précédente apparaissent ici. Saisissez un Name pour l’entitlement, puis cliquez sur Create Entitlement.

4

Attach It to a Product

Associez l’entitlement à n’importe quel produit. Consultez Associer des entitlements à des produits.

​

Parcours client

1. Le client finalise le checkout.
2. Dodo Payments crée un grant avec le statut Pending. Dodo Payments tente immédiatement de créer une URL d’autorisation Notion et l’enregistre dans oauth_url. En cas d’échec, oauth_url reste null jusqu’à ce que le client démarre le flux d’acceptation.
3. Dans le Customer Portal, le client clique sur Connecter pour l’entitlement, s’autorise avec Notion, sélectionne l’espace de travail qui recevra le template et partage au moins une page avec Dodo Payments.
4. Dodo Payments copie le template dans une page partagée de cet espace de travail. Le grant passe à Delivered.
5. Lors de la révocation, le grant est marqué Revoked, et la copie reste dans l’espace de travail du client.

​

Configuration requise

​

Créer via l’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"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created se déclenche avec status: "Pending". oauth_url peut déjà contenir l’URL d’autorisation Notion. S’il s’agit de null, elle est renseignée lorsque le client démarre le flux d’acceptation depuis le Customer Portal.
• entitlement_grant.delivered se déclenche une fois le template copié.
• entitlement_grant.revoked se déclenche lors de l’annulation. La copie du client reste inchangée.

​

Résolution des problèmes