> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Droit d'utilisation Notion

> Dupliquer un modèle Notion dans l'espace de travail du client lorsqu'il a acheté.

<Info>
  Le droit d'utilisation Notion duplique un modèle que vous avez préparé dans l'espace de travail Notion du client payant. Le client s'autorise via OAuth, choisit l'espace de travail dans lequel il souhaite copier le modèle, et Dodo Payments gère la duplication.
</Info>

## Ce qui est livré

* Le client est invité à connecter son espace de travail Notion via OAuth.
* Une fois autorisé, Dodo Payments duplique le modèle configuré dans l'espace de travail qu'ils ont choisi.
* En cas d'annulation, le modèle dupliqué reste dans l'espace de travail du client (Notion ne prend pas en charge la suppression à distance). Le droit est marqué `revoked` pour la tenue de registres.

Les utilisations courantes incluent les modèles Notion payants, les systèmes de productivité et les modèles OS/CRM.

## Connecter Notion

<Steps>
  <Step title="Open Entitlements">
    Dans votre tableau de bord Dodo Payments, allez à **Droits d'utilisation** et cliquez sur **+**.
  </Step>

  <Step title="Pick Notion">
    Choisissez **Modèle Notion** comme intégration. Si Notion n'est pas encore connecté, vous serez invité à **Connecter Notion**.

    <Frame caption="Connect Notion prompt before the OAuth handoff.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connect-prompt.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=90f1f2a60c96918a8da19665a24fcaca" alt="Nouveau panneau de droits invitant le marchand à connecter Notion" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1133" data-path="images/entitlements/notion/connect-prompt.png" />
    </Frame>

    En cliquant, Notion s'ouvre dans un nouvel onglet. Connectez-vous à l'espace de travail qui possède vos modèles sources, vérifiez les permissions demandées par Dodo Payments, puis choisissez les pages (modèles) que l'intégration est autorisée à lire et dupliquer.

    <Frame caption="Notion OAuth: review permissions, then pick the template pages to share.">
      <div style={{ display: 'flex', gap: '12px', flexWrap: 'wrap', justifyContent: 'center' }}>
        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-permissions.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=957e39812ac19bbf81cceb50f023a14a" alt="Écran des permissions OAuth Notion pour Dodo Payments" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1121" data-path="images/entitlements/notion/oauth-permissions.png" />

        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-select-pages.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=1f8bd414d5900f9d246d96f15877aba1" alt="Sélecteur de pages Notion sélectionnant les modèles auxquels Dodo Payments peut accéder" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1138" data-path="images/entitlements/notion/oauth-select-pages.png" />
      </div>
    </Frame>

    Lorsque Notion redirige, vous verrez une confirmation que l'espace de travail est connecté.

    <Frame caption="Workspace connected — return to the Dodo Payments dashboard to continue.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connected.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=5e526d2cc12c27f526b2a6e469157bd8" alt="Page de confirmation de connexion réussie du modèle Notion" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1143" data-path="images/entitlements/notion/connected.png" />
    </Frame>
  </Step>

  <Step title="Pick a template">
    Retournez dans le tableau de bord, sélectionnez le **modèle** à dupliquer depuis le sélecteur de modèle. Seules les pages que vous avez autorisées à l'étape précédente apparaissent ici. Donnez un **nom** au droit et cliquez sur **Créer un droit**.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/create.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=82a51c79ed0c6937abf866c187673ab7" alt="Formulaire de droit Notion avec espace de travail connecté, sélecteur de modèle et champ de nom" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1135" data-path="images/entitlements/notion/create.png" />
    </Frame>
  </Step>

  <Step title="Save the entitlement">
    Enregistrez et attachez à n'importe quel produit.
  </Step>
</Steps>

## Flux client

1. Le client finalise le paiement.
2. Dodo Payments crée un droit en statut `pending` avec un Notion `oauth_url` pour que le client connecte son espace de travail.
3. Le client autorise via le lien dans son email ou son portail client et choisit l'espace de travail dans lequel il souhaite dupliquer le modèle.
4. Dodo Payments duplique le modèle. Le droit passe à `delivered`.
5. En cas de révocation, le droit est marqué `revoked` ; la copie dupliquée reste dans l'espace de travail du client.

<Note>
  Notion considère intentionnellement une page dupliquée comme le contenu propre du destinataire. Dodo Payments ne peut pas supprimer la copie en cas de révocation.
</Note>

## Configuration requise

| Champ                | Requis | Description                                                   |
| -------------------- | ------ | ------------------------------------------------------------- |
| `notion_template_id` | Oui    | L'ID du modèle. Le sélecteur de tableau de bord remplit cela. |

## Créer via API

<CodeGroup>
  ```typescript TypeScript theme={null} theme={null}
  const entitlement = await client.entitlements.create({
    name: 'Study Notes',
    integration_type: 'notion',
    integration_config: {
      notion_template_id: 'tmpl_abc123',
    },
  });
  ```

  ```python Python theme={null} theme={null}
  client.entitlements.create(
      name="Study Notes",
      integration_type="notion",
      integration_config={"notion_template_id": "tmpl_abc123"},
  )
  ```

  ```go Go theme={null} theme={null}
  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("tmpl_abc123"),
      },
    ),
  })
  ```
</CodeGroup>

## Webhooks

Voir [les événements de webhook `entitlement_grant.*`](/developer-resources/webhooks/intents/entitlement-grant) :

* `entitlement_grant.created` inclut le Notion `oauth_url`.
* `entitlement_grant.delivered` se déclenche une fois le modèle dupliqué.
* `entitlement_grant.revoked` se déclenche en cas d'annulation ; la copie du client reste inchangée.

## Dépannage

<AccordionGroup>
  <Accordion title="Customer didn't get the template">
    Le droit reste `pending` jusqu'à ce que le client complète l'OAuth de Notion. Renouvelez l'envoi de l'email de livraison ; le lien OAuth expire après une semaine, après quoi vous pouvez révoquer et recréer le droit.
  </Accordion>

  <Accordion title="Template picker is empty">
    Reconnectez Notion depuis **Droits d'utilisation → Intégrations → Notion** avec l'espace de travail qui possède les modèles sources.
  </Accordion>

  <Accordion title="Customer wants the template removed after refund">
    Notion n'autorise pas la suppression à distance des pages dupliquées. Le client doit supprimer la copie de son propre espace de travail.
  </Accordion>
</AccordionGroup>
