Giới Thiệu

​

Entitlement là gì?

​

Các Tích Hợp Có Sẵn

​

Cách thức hoạt động của Grants

​

Vòng đời của Grant

​

Hành vi của Grant theo Sự kiện

​

Tạo Entitlement Đầu tiên

1

Open Entitlements

Đi tới Entitlements trong dashboard và nhấp vào + để tạo entitlement.

2

Pick an Integration

Chọn loại integration: License Key, Digital Files, Feature Flag, Discord, GitHub, Telegram, Figma, Framer hoặc Notion. Đối với integration nền tảng, trước tiên hãy kết nối tài khoản nếu bạn chưa thực hiện.

3

Configure Delivery

Điền các trường cho integration. Ví dụ: GitHub yêu cầu repository và mức quyền, Discord yêu cầu server và vai trò tùy chọn, còn License Key yêu cầu giới hạn activations và thời hạn license.

4

Save

Nhấp vào Create Entitlement. Giờ đây bạn có thể gắn entitlement vào bất kỳ product nào.

​

Gắn Entitlement vào Product

​

Trải nghiệm Khách hàng

​

Email và Customer Portal

​

Cung cấp dựa trên OAuth

​

Thu hồi

​

Quản lý Grant

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

// List grants for an entitlement
const grants = await client.entitlements.grants.list('ent_abc123', {
  status: 'Delivered',
});

// Revoke a single grant
await client.entitlements.grants.revoke('entg_xyz789', {
  id: 'ent_abc123',
});

# Assumes client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])
grants = client.entitlements.grants.list(
    "ent_abc123",
    status="Delivered",
)

client.entitlements.grants.revoke(
    "entg_xyz789",
    id="ent_abc123",
)

// Assumes client := dodopayments.NewClient() and ctx := context.Background().
grants, err := client.Entitlements.Grants.List(
  ctx, "ent_abc123",
  dodopayments.EntitlementGrantListParams{
    Status: dodopayments.F(dodopayments.EntitlementGrantListParamsStatusDelivered),
  },
)
if err != nil {
  panic(err.Error())
}
fmt.Println(len(grants.Items))

_, err = client.Entitlements.Grants.Revoke(ctx, "ent_abc123", "entg_xyz789")

​

Quản lý API

​

Webhook

​

Thực hành Tốt nhất

• Sử dụng một entitlement cho mỗi kênh cung cấp. Không dùng chung một entitlement Discord cho các product có mục đích vai trò khác nhau. Hãy tạo một entitlement cho mỗi vai trò để việc thu hồi luôn rõ ràng.
• Trước tiên hãy kiểm thử ở test mode. Tạo entitlement, gắn entitlement vào một product kiểm thử, thực hiện checkout và theo dõi grant chuyển từ Pending sang Delivered. Sau đó hủy subscription kiểm thử và xác nhận grant đã bị thu hồi.
• Lắng nghe entitlement_grant.delivered, không phải payment.succeeded. Một khoản thanh toán có thể thành công trước khi việc cung cấp hoàn tất, đặc biệt với các quy trình OAuth. Hãy chờ grant đạt Delivered trước khi mở khóa các tính năng phụ thuộc trong hệ thống của bạn. Grant được cung cấp ngay khi tạo, chẳng hạn license key tự động hoàn tất hoặc feature flag, sẽ đến dưới dạng entitlement_grant.created với status: "Delivered".
• Xem entitlement_grant.failed là trạng thái cần xử lý. Grant thất bại nghĩa là khách hàng đã thanh toán nhưng chưa nhận được quyền truy cập. Hiển thị các grant này cho đội ngũ hỗ trợ hoặc kích hoạt việc cấp lại.
• Ánh xạ revocation_reason vào các quy trình giữ chân khách hàng. Việc thu hồi subscription_on_hold có thể khôi phục vì khách hàng có thể cập nhật thẻ. Việc thu hồi manual là có chủ ý. Hãy xử lý chúng khác nhau trong thông báo gửi khách hàng.
• Không thu hồi quyền truy cập khi có subscription.past_due. Sự kiện đó mở ra thời gian gia hạn, và khách hàng vẫn giữ quyền truy cập cho đến khi khoảng thời gian kết thúc. Hãy chờ subscription.on_hold hoặc subscription.cancelled.