Quyền hạn Notion

​

Những gì được giao

• Khách hàng được nhắc kết nối workspace Notion của họ qua OAuth.
• Sau khi được ủy quyền, Dodo Payments sao chép template đã cấu hình vào workspace mà họ đã chọn.
• Khi hủy, template được sao chép vẫn nằm trong workspace của khách hàng (Notion không hỗ trợ xóa từ xa). Grant được đánh dấu Revoked để lưu hồ sơ.

​

Kết nối Notion

1

Open Entitlements

Trong bảng điều khiển Dodo Payments của bạn, đi tới Entitlements và nhấp vào +.

2

Pick Notion

Chọn Notion Template làm tích hợp. Nếu Notion chưa được kết nối, bạn sẽ được nhắc Kết nối Notion.

Nhấp qua sẽ mở Notion trong một tab mới. Đăng nhập vào không gian làm việc sở hữu các mẫu nguồn của bạn, xem xét các quyền mà Dodo Payments yêu cầu, sau đó chọn các trang (mẫu) mà tích hợp được phép đọc và nhân bản.

Khi Notion chuyển hướng trở lại, bạn sẽ thấy một xác nhận rằng không gian làm việc đã được kết nối.

3

Pick a template

Quay lại bảng điều khiển, chọn mẫu để nhân bản từ trình chọn mẫu. Chỉ các trang bạn đã ủy quyền ở bước trước mới xuất hiện ở đây. Đặt tên cho quyền hạn và nhấp Create Entitlement.

4

Save the entitlement

Lưu và đính kèm vào bất kỳ sản phẩm nào.

​

Luồng khách hàng

1. Khách hàng hoàn tất quy trình thanh toán.
2. Dodo Payments tạo một grant ở trạng thái Pending. oauth_url của grant là null cho đến khi khách hàng bắt đầu quy trình chấp nhận; lúc đó, trường này được điền bằng URL ủy quyền của Notion.
3. Khách hàng ủy quyền thông qua liên kết trong email hoặc Customer Portal, sau đó chọn workspace mà họ muốn sao chép template vào.
4. Dodo Payments sao chép template. Grant chuyển sang trạng thái Delivered.
5. Khi thu hồi, grant được đánh dấu là Revoked; bản sao đã sao chép vẫn còn trong workspace của khách hàng.

​

Cấu hình yêu cầu

​

Tạo qua API

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: 'tmpl_abc123',
  },
});

client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "tmpl_abc123"},
)

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"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created được kích hoạt với status: "Pending" và oauth_url vẫn là null; URL ủy quyền của Notion được điền sau khi khách hàng bắt đầu quy trình chấp nhận từ email phân phối hoặc 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ố