Notion-Berechtigung

​

Was bereitgestellt wird

• Der Kunde verbindet seinen Notion-Arbeitsbereich über das Customer Portal. In der Zahlungsbestätigungs-E-Mail wird das Entitlement als Action Required markiert und auf das Portal verwiesen.
• Nach der Autorisierung kopiert Dodo Payments die konfigurierte Vorlage in eine Seite, die der Kunde während der Autorisierung geteilt hat, und zwar in dem von ihm ausgewählten Arbeitsbereich.
• Wenn der Grant widerrufen wird, bleibt die Kopie im Arbeitsbereich des Kunden. Dodo Payments markiert den Grant zu Dokumentationszwecken als Revoked und löscht die Kopie nicht.

​

Notion verbinden

1

Open Entitlements

Gehen Sie im Dodo Payments-Dashboard zu Entitlements und klicken Sie auf +.

2

Pick Notion

Wählen Sie Notion Template als Integration aus. Wenn Notion noch nicht verbunden ist, klicken Sie auf Connect Notion.

Notion wird in einem neuen Tab geöffnet. Melden Sie sich in dem Arbeitsbereich an, in dem sich Ihre Quellvorlagen befinden, und überprüfen Sie die von Dodo Payments angeforderten Berechtigungen. Wählen Sie anschließend die Seiten (Vorlagen) aus, die die Integration lesen und kopieren darf.

Wenn Notion zurückleitet, wird auf einer Bestätigungsseite angezeigt, dass der Arbeitsbereich verbunden ist.

3

Pick a Template

Wählen Sie im Dashboard unter Template die zu kopierende Vorlage aus. Hier werden nur Seiten angezeigt, die Sie im vorherigen Schritt geteilt haben. Geben Sie unter Name einen Namen für das Entitlement ein und klicken Sie auf Create Entitlement.

4

Attach It to a Product

Verknüpfen Sie das Entitlement mit einem beliebigen Produkt. Siehe Entitlements mit Produkten verknüpfen.

​

Kundenablauf

1. Der Kunde schließt den Checkout ab.
2. Dodo Payments erstellt einen Grant im Status Pending. Dodo Payments versucht sofort, eine Notion-Autorisierungs-URL zu erstellen, und speichert sie in oauth_url. Falls dies fehlschlägt, bleibt oauth_url auf null, bis der Kunde den Accept-Flow startet.
3. Im Customer Portal klickt der Kunde beim Entitlement auf Connect, autorisiert sich bei Notion, wählt den Workspace aus, der die Vorlage erhalten soll, und teilt mindestens eine Seite mit Dodo Payments.
4. Dodo Payments kopiert die Vorlage in eine geteilte Seite in diesem Workspace. Der Grant wechselt zu Delivered.
5. Bei der Aufhebung wird der Grant als Revoked markiert, und die Kopie verbleibt im Workspace des Kunden.

​

Erforderliche Konfiguration

​

Über die API erstellen

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 wird mit status: "Pending" ausgelöst. oauth_url kann die Notion-Autorisierungs-URL bereits enthalten. Wenn der Wert null ist, wird er ausgefüllt, sobald der Kunde den Accept-Flow über das Customer Portal startet.
• entitlement_grant.delivered wird ausgelöst, sobald die Vorlage kopiert wurde.
• entitlement_grant.revoked wird bei einer Stornierung ausgelöst. Die Kopie des Kunden bleibt unverändert.

​

Fehlerbehebung