> ## 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.

# Notion-Berechtigung

> Duplizieren Sie eine Notion-Vorlage in den Arbeitsbereich des Kunden, wenn dieser sie kauft.

<Info>
  Die Notion-Berechtigung dupliziert eine von Ihnen vorbereitete Vorlage in den Notion-Arbeitsbereich des zahlenden Kunden. Der Kunde autorisiert über OAuth, wählt den Arbeitsbereich aus, in den die Vorlage kopiert werden soll, und Dodo Payments übernimmt die Duplikation.
</Info>

## Was wird geliefert

* Der Kunde wird aufgefordert, seinen Notion-Arbeitsbereich über OAuth zu verbinden.
* Nach der Autorisierung dupliziert Dodo Payments die konfigurierte Vorlage in den ausgewählten Arbeitsbereich.
* Bei einer Stornierung bleibt die duplizierte Vorlage im Arbeitsbereich des Kunden bestehen (Notion unterstützt keine Remote-Löschung). Die Erteilung wird zur Dokumentation als `revoked` markiert.

Häufige Anwendungen sind kostenpflichtige Notion-Vorlagen, Produktivitätssysteme und OS/CRM-Vorlagen.

## Notion verbinden

<Steps>
  <Step title="Open Entitlements">
    Gehen Sie in Ihrem Dodo Payments-Dashboard zu **Berechtigungen** und klicken Sie auf **+**.
  </Step>

  <Step title="Pick Notion">
    Wählen Sie **Notion-Vorlage** als Integration. Wenn Notion noch nicht verbunden ist, werden Sie aufgefordert, **Notion zu verbinden**.

    <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="Neues Berechtigungspanel, das den Händler auffordert, Notion zu verbinden" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1133" data-path="images/entitlements/notion/connect-prompt.png" />
    </Frame>

    Durch Klicken öffnet sich Notion in einem neuen Tab. Melden Sie sich bei dem Arbeitsbereich an, dem Ihre Quellvorlagen gehören, überprüfen Sie die von Dodo Payments angeforderten Berechtigungen und wählen Sie dann die Seiten (Vorlagen) aus, die die Integration lesen und duplizieren darf.

    <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="Notion OAuth-Berechtigungsbildschirm für 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="Notion-Seiten-Auswahldialog zur Auswahl, welche Vorlagen Dodo Payments zugreifen darf" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1138" data-path="images/entitlements/notion/oauth-select-pages.png" />
      </div>
    </Frame>

    Wenn Notion zurückleitet, sehen Sie eine Bestätigung, dass der Arbeitsbereich verbunden ist.

    <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="Erfolgreiche Bestätigungsseite zur verbundenen Notion-Vorlage" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1143" data-path="images/entitlements/notion/connected.png" />
    </Frame>
  </Step>

  <Step title="Pick a template">
    Zurück im Dashboard wählen Sie die **Vorlage** zum Duplizieren aus dem Vorlagen-Picker. Hier erscheinen nur die Seiten, die Sie im vorherigen Schritt autorisiert haben. Geben Sie der Berechtigung einen **Namen** und klicken Sie auf **Berechtigung erstellen**.

    <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="Notion-Berechtigungsform mit verbundenem Arbeitsbereich, Vorlagen-Picker und Namensfeld" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1135" data-path="images/entitlements/notion/create.png" />
    </Frame>
  </Step>

  <Step title="Save the entitlement">
    Speichern und jedem Produkt anhängen.
  </Step>
</Steps>

## Kundenablauf

1. Der Kunde schließt den Kauf ab.
2. Dodo Payments erstellt eine Erteilung im `pending`-Status mit einem Notion `oauth_url`, damit der Kunde seinen Arbeitsbereich verbinden kann.
3. Der Kunde autorisiert über den Link in seiner E-Mail oder im Kundenportal und wählt den Arbeitsbereich, in den die Vorlage dupliziert werden soll.
4. Dodo Payments dupliziert die Vorlage. Die Erteilung geht in den `delivered` über.
5. Bei Widerruf wird die Erteilung als `revoked` markiert; die duplizierte Kopie bleibt im Arbeitsbereich des Kunden.

<Note>
  Notion behandelt eine duplizierte Seite absichtlich als eigenen Inhalt des Empfängers. Dodo Payments kann die Kopie bei Widerruf nicht löschen.
</Note>

## Erforderliche Konfiguration

| Feld                 | Erforderlich | Beschreibung                                          |
| -------------------- | ------------ | ----------------------------------------------------- |
| `notion_template_id` | Ja           | Die Vorlagen-ID. Der Dashboard-Picker füllt dies aus. |

## Erstellen über 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

Siehe [`entitlement_grant.*` Webhook-Ereignisse](/developer-resources/webhooks/intents/entitlement-grant):

* `entitlement_grant.created` beinhaltet das Notion `oauth_url`.
* `entitlement_grant.delivered` wird ausgelöst, sobald die Vorlage dupliziert ist.
* `entitlement_grant.revoked` wird bei einer Stornierung ausgelöst; die Kopie des Kunden bleibt unberührt.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Customer didn't get the template">
    Die Erteilung bleibt im `pending`, bis der Kunde das Notion OAuth abschließt. Senden Sie die Liefer-E-Mail erneut; der OAuth-Link läuft nach einer Woche ab, danach können Sie die Erteilung widerrufen und neu erstellen.
  </Accordion>

  <Accordion title="Template picker is empty">
    Verbinden Sie Notion von **Berechtigungen → Integrationen → Notion** erneut mit dem Arbeitsbereich, dem die Quellvorlagen gehören.
  </Accordion>

  <Accordion title="Customer wants the template removed after refund">
    Notion erlaubt keine Remote-Löschung duplizierter Seiten. Der Kunde muss die Kopie aus seinem eigenen Arbeitsbereich löschen.
  </Accordion>
</AccordionGroup>