Notion エンタイトルメント

​

配信される内容

• 顧客は Customer Portal から自身の Notion ワークスペースを接続します。支払い確認メールでは entitlement が Action Required と表示され、ポータルへのリンクが記載されます。
• 認証後、Dodo Payments は設定済みのテンプレートを、顧客が認証中に共有したページへ、顧客が選択したワークスペース内でコピーします。
• grant が取り消されても、コピーは顧客のワークスペースに残ります。Dodo Payments は記録保持のため grant を Revoked としてマークしますが、コピーは削除しません。

​

Notionの接続

1

Open Entitlements

Dodo Payments ダッシュボードで Entitlements に移動し、+ をクリックします。

2

Pick Notion

統合として Notion Template を選択します。Notion がまだ接続されていない場合は、Connect Notion をクリックします。

Notion が新しいタブで開きます。ソーステンプレートを所有するワークスペースにサインインし、Dodo Payments が要求する権限を確認します。次に、統合が読み取りとコピーを行えるページ（テンプレート）を選択します。

Notion から戻ると、ワークスペースが接続されたことを確認するページが表示されます。

3

Pick a Template

ダッシュボードに戻り、Template でコピーするテンプレートを選択します。ここには前の手順で共有したページのみが表示されます。entitlement の Name を入力し、Create Entitlement をクリックします。

4

Attach It to a Product

entitlement を任意の product に関連付けます。詳しくは Entitlement を Product に関連付ける を参照してください。

​

顧客フロー

1. 顧客がチェックアウトを完了します。
2. Dodo Payments が Pending ステータスで grant を作成します。Dodo Payments はすぐに Notion authorization URL の作成を試み、その URL を oauth_url に保存します。失敗した場合、顧客が accept フローを開始するまで oauth_url は null のままです。
3. Customer Portal で、顧客は entitlement の 接続 をクリックし、Notion で認証を行い、テンプレートを受け取るワークスペースを選択して、少なくとも 1 つのページを Dodo Payments と共有します。
4. Dodo Payments はテンプレートをそのワークスペース内の共有ページにコピーします。grant は Delivered に移行します。
5. revoke 時に grant は Revoked としてマークされ、コピーは顧客のワークスペースに残ります。

​

必須設定

​

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 が status: "Pending" とともに発生します。oauth_url には、すでに Notion authorization URL が格納されている場合があります。null の場合、顧客が Customer Portal から accept フローを開始すると値が設定されます。
• テンプレートのコピーが完了すると、entitlement_grant.delivered が発生します。
• キャンセル時に entitlement_grant.revoked が発生します。顧客のコピーには変更を加えません。

​

トラブルシューティング