Quyền hạn Notion

​

Nội dung được cung cấp

• Khách hàng kết nối workspace Notion của họ từ Customer Portal. Email xác nhận thanh toán đánh dấu entitlement là Action Required và liên kết đến portal.
• Sau khi họ ủy quyền, Dodo Payments sao chép template đã cấu hình vào một page mà khách hàng đã chia sẻ trong quá trình ủy quyền, thuộc workspace họ đã chọn.
• Khi grant bị thu hồi, bản sao vẫn nằm trong workspace của khách hàng. Dodo Payments đánh dấu grant là Revoked để lưu hồ sơ và không xóa bản sao.

​

Kết nối Notion

1

Open Entitlements

Trong dashboard Dodo Payments, đi đến Entitlements và nhấp vào +.

2

Pick Notion

Chọn Notion Template làm integration. Nếu Notion chưa được kết nối, hãy nhấp vào Connect Notion.

Notion mở trong tab mới. Đăng nhập vào workspace sở hữu các template nguồn của bạn và xem lại các quyền mà Dodo Payments yêu cầu. Sau đó chọn các page (template) mà integration có thể đọc và sao chép.

Khi Notion chuyển hướng trở lại, một trang xác nhận cho biết workspace đã được kết nối.

3

Pick a Template

Quay lại dashboard, chọn template cần sao chép trong Template. Chỉ những page bạn đã chia sẻ ở bước trước mới xuất hiện tại đây. Nhập Name cho entitlement và nhấp vào Create Entitlement.

4

Attach It to a Product

Đính kèm entitlement vào bất kỳ product nào. Xem Đính kèm Entitlements vào Products.

​

Luồng khách hàng

1. Khách hàng hoàn tất bước thanh toán.
2. Dodo Payments tạo một grant ở trạng thái Pending. Dodo Payments cố gắng tạo URL ủy quyền Notion ngay lập tức và lưu URL đó vào oauth_url. Nếu không thành công, oauth_url vẫn giữ giá trị null cho đến khi khách hàng bắt đầu quy trình chấp nhận.
3. Trong Customer Portal, khách hàng nhấp vào Connect trên entitlement, ủy quyền với Notion, chọn workspace để nhận template và chia sẻ ít nhất một page với Dodo Payments.
4. Dodo Payments sao chép template vào một page được chia sẻ trong workspace đó. Grant chuyển sang Delivered.
5. Khi thu hồi, grant được đánh dấu là Revoked, còn bản sao vẫn được giữ trong workspace của khách hàng.

​

Cấu hình bắt buộc

​

Tạo qua 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 được kích hoạt với status: "Pending". oauth_url có thể đã chứa URL ủy quyền Notion. Nếu có giá trị null, URL sẽ được điền khi khách hàng bắt đầu quy trình chấp nhận từ Customer Portal.
• entitlement_grant.delivered được kích hoạt sau khi template được sao chép.
• entitlement_grant.revoked được kích hoạt khi hủy. Bản sao của khách hàng không bị thay đổi.

​

Khắc phục sự cố