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를 모든 제품에 연결할 수 있습니다. Entitlements를 제품에 연결하기를 참조하세요.

​

고객 플로우

1. 고객이 결제를 완료합니다.
2. Dodo Payments가 Pending 상태의 grant를 생성합니다. Dodo Payments는 즉시 Notion authorization URL을 생성하려고 시도하고 이를 oauth_url에 저장합니다. 이 작업이 실패하면 고객이 accept flow를 시작할 때까지 oauth_url는 null 상태로 유지됩니다.
3. Customer Portal에서 고객이 entitlement의 Connect를 클릭하고 Notion으로 authorization을 완료한 다음, 템플릿을 받을 workspace를 선택하고 Dodo Payments와 하나 이상의 페이지를 공유합니다.
4. Dodo Payments가 해당 workspace의 공유 페이지에 템플릿을 복사합니다. grant가 Delivered 상태로 변경됩니다.
5. revocation 시 grant가 Revoked로 표시되며, 복사본은 고객의 workspace에 그대로 남습니다.

​

필수 구성

​

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 flow를 시작하면 해당 값이 채워집니다.
• 템플릿이 복사되면 entitlement_grant.delivered가 발생합니다.
• 취소 시 entitlement_grant.revoked가 발생합니다. 고객의 복사본은 변경되지 않은 상태로 유지됩니다.

​

문제 해결