Trao Quyền

Sự Kiện Webhook Trao Quyền

Các sự kiện này được kích hoạt mỗi khi quyền của khách hàng thay đổi trạng thái, ví dụ khi một license key được tạo, một vai trò Discord được gán, một liên kết tải xuống được cung cấp hoặc quyền truy cập bị từ chối. Đăng ký các sự kiện này để giữ cho ứng dụng của bạn đồng bộ với những gì mỗi khách hàng có thể truy cập.

Event	Description
`entitlement_grant.created`	Một grant mới đã được tạo. Trạng thái là `Delivered` ngay lập tức đối với license key được tự động fulfillment, và `Pending` đối với license key được fulfillment thủ công và mọi integration khác.
`entitlement_grant.delivered`	Grant chuyển sang trạng thái đã được delivered. Customer hiện có quyền truy cập vào platform, file hoặc license key được entitlement cấp.
`entitlement_grant.failed`	Delivery thất bại và sẽ không được retry. Kiểm tra `error_code` và `error_message`.
`entitlement_grant.revoked`	Quyền truy cập đã bị thu hồi. Kiểm tra `revocation_reason` để hiểu lý do.

Cả bốn sự kiện đều chia sẻ cùng một tải trọng EntitlementGrantResponse được tài liệu hóa trong sơ đồ dưới đây.

Kích Hoạt Sự Kiện

entitlement_grant.created

Một dòng cấp quyền vừa được chèn. Quyền luôn có một id ổn định từ lúc này, ngay cả khi trạng thái của nó thay đổi. Sử dụng sự kiện này để ghi lại rằng việc thực hiện đang diễn ra. Đối với license key được tự động fulfillment, row được insert trực tiếp với status: "Delivered" và delivered_at đã được điền, vì vậy một event created duy nhất sẽ không có thêm thay đổi trạng thái nào, trừ khi grant bị revoke về sau. Đối với license key được fulfillment thủ công (entitlement có fulfillment_mode: manual), row được tạo với status: "Pending" và không có object license_key — chưa có key. Event này báo hiệu rằng một key đang chờ fulfillment; hãy cung cấp key qua POST /grants/{grant_id}/license-key, sau đó event entitlement_grant.delivered sẽ được phát. Xem Manual Fulfillment. Đối với mọi integration khác, row được tạo với status: "Pending". Một event delivered hoặc failed sẽ được phát sau khi delivery hoàn tất:

Integration dựa trên OAuth (Discord, GitHub, Notion) chứa một oauth_url mà customer phải truy cập để hoàn tất việc cấp consent. Grant vẫn ở trạng thái Pending cho đến khi customer authorize.
Integration trực tiếp với platform (Telegram, Framer, Digital Files) chỉ ở trạng thái Pending trong thời gian ngắn khi platform call đang chạy, sau đó chuyển sang Delivered.

Quyền đã chuyển từ pending sang delivered. Khách hàng hiện có quyền truy cập như đã mô tả trong quyền. Sử dụng sự kiện này để mở khóa các tính năng phụ thuộc trong hệ thống của bạn, ví dụ để cung cấp một không gian làm việc, gửi email chào mừng tùy chỉnh hoặc đánh dấu một cờ “đã hoàn thành”. Grant đã chuyển từ Pending sang Delivered. Customer hiện có quyền truy cập được mô tả trong entitlement. Sử dụng event này để mở khóa các tính năng phụ thuộc trong hệ thống của bạn, chẳng hạn như provision một workspace, gửi email chào mừng tùy chỉnh hoặc đánh dấu cờ “fulfilled”. Trường delivered_at trong payload ghi nhận thời điểm delivery hoàn tất. Đối với các grant có trạng thái Delivered ngay khi được tạo, bạn sẽ nhận được các event created và delivered liên tiếp. Giao hàng đã được thử nghiệm nhưng thất bại với lỗi không thể thử lại. Các trường error_code và error_message giải thích lý do thất bại. Nguyên nhân phổ biến bao gồm token OAuth bị thu hồi, quyền nền tảng bị từ chối, hoặc mục tiêu bị thiếu (ví dụ, một guild Discord đã bị xóa).

Xử lý entitlement_grant.failed như một hành động có thể thực hiện. Khách hàng đã thanh toán nhưng không nhận được quyền truy cập. Hiển thị các thất bại cho đội ngũ hỗ trợ của bạn hoặc kích hoạt lại sau khi vấn đề cơ bản được giải quyết.

entitlement_grant.revoked

Quyền truy cập đã bị rút lại ở cấp độ nền tảng: vai trò Discord bị xóa, cộng tác viên GitHub bị xóa, key giấy phép bị vô hiệu hóa, URL tải xuống tệp không còn được cấp phát. Trường revocation_reason ghi lại kích hoạt.

`revocation_reason`	Kích Hoạt
`subscription_cancelled`	Đăng ký của khách hàng đã bị hủy (sự kiện `subscription.cancelled`).
`subscription_on_hold`	Đăng ký đang bị tạm giữ do gia hạn thất bại (`subscription.on_hold`). Có thể khôi phục: một lần thử lại thành công sẽ cấp quyền lại.
`subscription_expired`	Đăng ký đã đạt đến ngày kết thúc nhiệm kỳ (`subscription.expired`).
`plan_changed`	Kế hoạch đã thay đổi; quyền cũ bị thu hồi trước khi cấp quyền mới (`subscription.plan_changed`).
`refund`	Đã xử lý một khoản hoàn tiền cho thanh toán một lần ban đầu (`refund.succeeded`).
`manual`	Một nhà cung cấp hủy bỏ quyền thông qua API hoặc bảng điều khiển. Khi thu hồi thủ công, sẽ không tự động cấp lại khi gia hạn đăng ký.
`license_key_disabled`	Key sau một quyền cấp license-key đã bị vô hiệu hóa. Quyền được kích hoạt lại tự động nếu key được tái kích hoạt.
`platform_external`	Phía nền tảng của một tích hợp không đồng bộ (ví dụ, vai trò Discord bị xóa thủ công, Ứng dụng GitHub mất quyền truy cập kho, hoặc kiểm tra đối chiếu phát hiện thiếu mục tiêu). Quyền sẽ không tự động cấp lại khi gia hạn đăng ký cho đến khi vấn đề nền tảng cơ bản được giải quyết.

`revocation_reason`	Kích hoạt
`subscription_cancelled`	Gói đăng ký của khách hàng đã bị hủy (sự kiện `subscription.cancelled`).
`subscription_on_hold`	Gói đăng ký đang bị tạm giữ do gia hạn không thành công (`subscription.on_hold`). Có thể khôi phục: lần thử lại thành công sẽ cấp lại quyền.
`SubscriptionPaused`	Gói đăng ký đã bị tạm dừng (`subscription.paused`). Có thể khôi phục: việc tiếp tục sẽ cấp lại quyền.
`subscription_expired`	Gói đăng ký đã kết thúc thời hạn (`subscription.expired`).
`plan_changed`	Gói đã thay đổi; các quyền cấp cũ sẽ bị thu hồi trước khi cấp các quyền mới (`subscription.plan_changed`).
`refund`	Khoản hoàn tiền đã được xử lý cho khoản thanh toán một lần ban đầu (`refund.succeeded`).
`manual`	Merchant đã thu hồi quyền cấp thông qua API hoặc dashboard. Quyền cấp bị thu hồi thủ công sẽ không được tự động cấp lại khi gia hạn gói đăng ký.
`license_key_disabled`	License key đứng sau quyền cấp license key đã bị vô hiệu hóa. Quyền cấp sẽ tự động được kích hoạt lại nếu license key được bật lại.
`platform_external`	Phía nền tảng của một integration đã không còn đồng bộ (ví dụ: một vai trò Discord bị xóa thủ công, GitHub App mất quyền truy cập repository hoặc một lượt reconciliation phát hiện target bị thiếu). Quyền cấp sẽ không được tự động cấp lại khi gia hạn gói đăng ký cho đến khi vấn đề của nền tảng cơ sở được giải quyết.

Biến Thể Payload

Trường data luôn là một đối tượng EntitlementGrantResponse. Hai kiểu tích hợp đính kèm thêm các đối tượng con: Trường data luôn là một object EntitlementGrantResponse. Payload chứa một trường integration_type (ví dụ license_key, digital_files, discord) để bạn có thể nhận diện trực tiếp loại grant. Ba loại integration cũng đính kèm các object nested bổ sung:

license_key được bao gồm khi integration_type là license_key và một key đã được cấp. Object này chứa key được tạo, thời hạn hết hạn và thông tin sử dụng activation. Đối với grant được fulfillment thủ công vẫn ở trạng thái Pending, object này là null cho đến khi bạn fulfillment grant.
digital_product_delivery được bao gồm khi integration_type là digital_files. Object này chứa các URL download presigned, instructions tùy chọn và external_url tùy chọn.
feature được bao gồm khi integration_type là feature_flag. Object này chứa feature_type và feature_id của capability được grant cấp.

Đối với tất cả các loại integration khác (Discord, GitHub, Telegram, Figma, Framer, Notion), các field nested này là null; cấu hình liên quan được lưu trong entitlement, không phải trong grant.

Payload Ví Dụ

License key được giao (`entitlement_grant.delivered`)

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.delivered",
  "timestamp": "2026-05-01T10:25:33.000000Z",
  "data": {
    "id": "grant_8VbC6JDZzPEqfBPUdpj0K",
    "business_id": "bus_H4ekzPSlcg",
    "entitlement_id": "ent_9xY2bKwQn5MjRpL8d",
    "customer_id": "cus_abc123",
    "external_id": "lk_AAA111BBB222",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "delivered",
    "license_key": {
      "key": "PRO-AAAA-BBBB-CCCC-DDDD",
      "expires_at": "2027-05-01T00:00:00Z",
      "activations_used": 0,
      "activations_limit": 5
    },
    "digital_product_delivery": null,
    "delivered_at": "2026-05-01T10:25:33Z",
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:25:33Z",
    "updated_at": "2026-05-01T10:25:33Z"
  }
}

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.delivered",
  "timestamp": "2026-05-01T10:25:33.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_8VbC6JDZzPEqfBPUdpj0K",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_9xY2bKwQn5MjRpL8d",
    "customer_id": "cus_abc123",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "Delivered",
    "integration_type": "license_key",
    "license_key": {
      "key": "PRO-AAAA-BBBB-CCCC-DDDD",
      "expires_at": "2027-05-01T00:00:00Z",
      "activations_used": 0,
      "activations_limit": 5
    },
    "digital_product_delivery": null,
    "delivered_at": "2026-05-01T10:25:33Z",
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:25:33Z",
    "updated_at": "2026-05-01T10:25:33Z"
  }
}

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.delivered",
  "timestamp": "2026-05-01T10:30:12.000000Z",
  "data": {
    "id": "grant_2P9rQwYvMxTnKoCb4",
    "business_id": "bus_H4ekzPSlcg",
    "entitlement_id": "ent_files_J3kLmN4oP5",
    "customer_id": "cus_abc123",
    "external_id": "pay_a1b2c3d4",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "delivered",
    "license_key": null,
    "digital_product_delivery": {
      "files": [
        {
          "file_id": "df_a4f6c1de",
          "download_url": "https://files.dodopayments.com/.../pro-bundle.zip?Signature=...",
          "filename": "pro-bundle.zip",
          "content_type": "application/zip",
          "file_size": 18742390,
          "expires_in": 900
        }
      ],
      "instructions": "Unzip and run setup.sh from the project root.",
      "external_url": null
    },
    "delivered_at": "2026-05-01T10:30:12Z",
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:30:12Z",
    "updated_at": "2026-05-01T10:30:12Z"
  }
}

Được phát khi customer mua một product có entitlement License Key sử dụng fulfillment_mode: manual. Grant ở trạng thái Pending và chưa có object license_key — merchant phải cung cấp key.

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.created",
  "timestamp": "2026-05-01T10:24:00.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_8VbC6JDZzPEqfBPUdpj0K",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_9xY2bKwQn5MjRpL8d",
    "customer_id": "cus_abc123",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "Pending",
    "integration_type": "license_key",
    "license_key": null,
    "digital_product_delivery": null,
    "delivered_at": null,
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:24:00Z",
    "updated_at": "2026-05-01T10:24:00Z"
  }
}

Quyền bị thu hồi khi hủy đăng ký (`entitlement_grant.revoked`)

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.delivered",
  "timestamp": "2026-05-01T10:30:12.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_2P9rQwYvMxTnKoCb4",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_files_J3kLmN4oP5",
    "customer_id": "cus_abc123",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "Delivered",
    "integration_type": "digital_files",
    "license_key": null,
    "digital_product_delivery": {
      "files": [
        {
          "file_id": "df_a4f6c1de",
          "download_url": "https://files.dodopayments.com/.../pro-bundle.zip?Signature=...",
          "filename": "pro-bundle.zip",
          "content_type": "application/zip",
          "file_size": 18742390,
          "expires_in": 900
        }
      ],
      "instructions": "Unzip and run setup.sh from the project root.",
      "external_url": null
    },
    "delivered_at": "2026-05-01T10:30:12Z",
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:30:12Z",
    "updated_at": "2026-05-01T10:30:12Z"
  }
}

Giao hàng thất bại (`entitlement_grant.failed`)

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.created",
  "timestamp": "2026-05-01T10:31:00.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_DiscordPending5L",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_discord_patrons",
    "customer_id": "cus_abc123",
    "payment_id": null,
    "subscription_id": "sub_pro_monthly_001",
    "status": "Pending",
    "integration_type": "discord",
    "license_key": null,
    "digital_product_delivery": null,
    "delivered_at": null,
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": null,
    "error_message": null,
    "oauth_url": "https://discord.com/oauth2/authorize?...",
    "oauth_expires_at": "2026-05-08T10:31:00Z",
    "metadata": null,
    "created_at": "2026-05-01T10:31:00Z",
    "updated_at": "2026-05-01T10:31:00Z"
  }
}

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.revoked",
  "timestamp": "2026-06-15T08:12:44.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_8VbC6JDZzPEqfBPUdpj0K",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_9xY2bKwQn5MjRpL8d",
    "customer_id": "cus_abc123",
    "payment_id": null,
    "subscription_id": "sub_pro_monthly_001",
    "status": "Revoked",
    "integration_type": "license_key",
    "revocation_reason": "subscription_cancelled",
    "license_key": {
      "key": "PRO-AAAA-BBBB-CCCC-DDDD",
      "expires_at": null,
      "activations_used": 1,
      "activations_limit": 5
    },
    "digital_product_delivery": null,
    "delivered_at": "2026-05-01T10:25:33Z",
    "revoked_at": "2026-06-15T08:12:44Z",
    "error_code": null,
    "error_message": null,
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:25:33Z",
    "updated_at": "2026-06-15T08:12:44Z"
  }
}

Chờ entitlement_grant.delivered trước khi mở khóa các tính năng phụ thuộc. Một sự kiện payment.succeeded cho bạn biết tiền đã được giải ngân; nó không cho bạn biết rằng khách hàng đã có repo GitHub hoặc vai trò Discord. Sự kiện delivered là nguồn sự thật cho việc thực hiện.
Lập bản đồ revocation_reason đến luồng giữ chân người dùng. Một quyền hồi lại subscription_on_hold thường có nghĩa là thẻ của khách hàng đã thất bại và lần gia hạn tiếp theo sẽ cấp lại quyền. Một quyền hồi lại manual hoặc subscription_cancelled là có chủ ý. Xử lý chúng khác nhau trong thông báo khách hàng.
Sử dụng quyền id như là khóa idempotency của bạn. Một quyền duy nhất phát ra nhiều nhất một sự kiện created và nhiều nhất một sự kiện cuối cùng (delivered hoặc failed), và nhiều nhất một sự kiện revoked. Các đợt giao lại từ hệ thống webhook có thể lặp lại các sự kiện; loại bỏ trùng lặp trên cấp quyền id cộng type.
Kiểm tra license_key và digital_product_delivery để nhận biết kiểu tích hợp. Bản thân tải trọng quyền không mang kiểu tích hợp, nhưng chính xác một trong các đối tượng con này được điền cho các quyền license-key và tệp kỹ thuật số.
Đối với các quyền dựa trên OAuth, hiển thị oauth_url cho khách hàng. Sự kiện entitlement_grant.created cho luồng thuê bao Discord, GitHub hoặc Notion bao gồm một oauth_url và oauth_expires_at. Gửi email nó cho khách hàng hoặc hiển thị trong ứng dụng của bạn để giải phóng việc giao hàng.

{
  "business_id": "bus_H4ekzPSlcg",
  "type": "entitlement_grant.failed",
  "timestamp": "2026-05-01T10:36:21.000000Z",
  "data": {
    "payload_type": "EntitlementGrant",
    "id": "grant_GhFailed7Z",
    "business_id": "bus_H4ekzPSlcg",
    "brand_id": "brd_123",
    "entitlement_id": "ent_github_repo",
    "customer_id": "cus_abc123",
    "payment_id": "pay_a1b2c3d4",
    "subscription_id": null,
    "status": "Failed",
    "integration_type": "github",
    "license_key": null,
    "digital_product_delivery": null,
    "delivered_at": null,
    "revoked_at": null,
    "revocation_reason": null,
    "error_code": "github_permission_denied",
    "error_message": "Repository access could not be granted: the GitHub App installation no longer has permission on this repository.",
    "oauth_url": null,
    "oauth_expires_at": null,
    "metadata": null,
    "created_at": "2026-05-01T10:36:00Z",
    "updated_at": "2026-05-01T10:36:21Z"
  }
}

Mẹo Tích Hợp

Chờ entitlement_grant.delivered trước khi mở khóa các tính năng phụ thuộc. Event payment.succeeded cho biết khoản tiền đã được xử lý thành công; event này không cho biết customer đã có GitHub repo hoặc Discord role hay chưa. Event delivered là nguồn dữ liệu chính thức cho fulfillment.
Map revocation_reason vào các flow retention. Việc revoke subscription_on_hold thường có nghĩa là thẻ của customer đã bị từ chối và lần renewal tiếp theo sẽ grant lại quyền truy cập. Việc revoke manual hoặc subscription_cancelled là có chủ ý. Hãy xử lý chúng khác nhau trong thông báo gửi customer.
Sử dụng id của grant làm idempotency key. Một grant chỉ phát tối đa một event created, tối đa một event kết thúc (delivered hoặc failed), và tối đa một event revoked. Hệ thống webhook có thể gửi lại event; hãy dedupe dựa trên id của grant cùng với type.
Đọc integration_type để nhận diện loại grant. Payload chứa trực tiếp integration_type (ví dụ license_key, digital_files, discord). Các object nested license_key và digital_product_delivery được điền sau khi các grant tương ứng được delivered; grant license key được fulfillment thủ công vẫn ở trạng thái Pending với integration_type: "license_key" và null license_key cho đến khi bạn fulfillment grant.
Đối với các grant OAuth, hiển thị oauth_url cho customer. Event entitlement_grant.created cho flow subscriber của Discord, GitHub hoặc Notion chứa oauth_url và oauth_expires_at. Gửi URL đó qua email cho customer hoặc hiển thị trong app của bạn để hoàn tất delivery.

Detailed view of a single entitlement grant: who it's for, its lifecycle state, and any integration-specific delivery payload.

brand_id

string

bắt buộc

Brand id this grant belongs to.

business_id

string

bắt buộc

Identifier of the business that owns the grant.

created_at

string<date-time>

bắt buộc

Timestamp when the grant was created.

customer_id

string

bắt buộc

Identifier of the customer the grant was issued to.

entitlement_id

string

bắt buộc

Identifier of the entitlement this grant was issued from.

string

bắt buộc

Unique identifier of the grant.

integration_type

enum<string>

bắt buộc

The integration type of the grant's entitlement (e.g. license_key).

Tùy chọn có sẵn:

discord,

telegram,

github,

figma,

framer,

notion,

digital_files,

license_key,

feature_flag

metadata

Metadata · object

bắt buộc

Arbitrary key-value metadata recorded on the grant.

Show child attributes

status

enum<string>

bắt buộc

Lifecycle status of the grant.

Tùy chọn có sẵn:

Pending,

Delivered,

Failed,

Revoked

updated_at

string<date-time>

bắt buộc

Timestamp when the grant was last modified.

delivered_at

string<date-time> | null

Timestamp when the grant transitioned to delivered, when applicable.

digital_product_delivery

null | Digital Product Delivery · object

Digital-product-delivery payload, present when the entitlement integration is digital_files.

Show child attributes

error_code

string | null

Machine-readable code reported when delivery failed, when applicable.

error_message

string | null

Human-readable message reported when delivery failed, when applicable.

feature

null | object

Typed feature payload, present only when the entitlement integration is feature_flag; null for every other integration type.

Show child attributes

license_key

null | object

License-key delivery payload, present when the entitlement integration is license_key.

Show child attributes

oauth_expires_at

string<date-time> | null

Timestamp when oauth_url stops being valid, when applicable.

oauth_url

string | null

Customer-facing OAuth URL for OAuth-style integrations. Populated during the customer-portal accept flow; null until the customer completes that step, and on grants for non-OAuth integrations.

payment_id

string | null

Identifier of the payment that triggered this grant, when applicable.

revocation_reason

string | null

Reason recorded when the grant was revoked, when applicable.

revoked_at

string<date-time> | null

Timestamp when the grant transitioned to revoked, when applicable.

subscription_id

string | null

Identifier of the subscription that triggered this grant, when applicable.

Lần sửa đổi cuối 21 tháng 8, 2026

{
  "brand_id": "<string>",
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "customer_id": "<string>",
  "entitlement_id": "<string>",
  "id": "<string>",
  "metadata": {},
  "updated_at": "2023-11-07T05:31:56Z",
  "delivered_at": "2023-11-07T05:31:56Z",
  "digital_product_delivery": {
    "files": [
      {
        "download_url": "<string>",
        "expires_in": 123,
        "file_id": "<string>",
        "filename": "<string>",
        "content_type": "<string>",
        "file_size": 123
      }
    ],
    "external_url": "<string>",
    "instructions": "<string>"
  },
  "error_code": "<string>",
  "error_message": "<string>",
  "feature": {
    "feature_id": "<string>",
    "feature_type": "boolean"
  },
  "license_key": {
    "activations_used": 123,
    "key": "<string>",
    "activations_limit": 123,
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "oauth_expires_at": "2023-11-07T05:31:56Z",
  "oauth_url": "<string>",
  "payment_id": "<string>",
  "revocation_reason": "<string>",
  "revoked_at": "2023-11-07T05:31:56Z",
  "subscription_id": "<string>"
}

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Sự Kiện Webhook Trao Quyền

Kích Hoạt Sự Kiện

entitlement_grant.created

entitlement_grant.revoked

Biến Thể Payload

Payload Ví Dụ

License key được giao (`entitlement_grant.delivered`)

Quyền bị thu hồi khi hủy đăng ký (`entitlement_grant.revoked`)

Giao hàng thất bại (`entitlement_grant.failed`)

Mẹo Tích Hợp

​Sự Kiện Webhook Trao Quyền

​Kích Hoạt Sự Kiện

​entitlement_grant.created

​entitlement_grant.revoked

​Biến Thể Payload

​Payload Ví Dụ

​License key được giao (entitlement_grant.delivered)

​Quyền bị thu hồi khi hủy đăng ký (entitlement_grant.revoked)

​Giao hàng thất bại (entitlement_grant.failed)

​Mẹo Tích Hợp

Sự Kiện Webhook Trao Quyền

Kích Hoạt Sự Kiện

entitlement_grant.created

entitlement_grant.revoked

Biến Thể Payload

Payload Ví Dụ

License key được giao (`entitlement_grant.delivered`)

Quyền bị thu hồi khi hủy đăng ký (`entitlement_grant.revoked`)

Giao hàng thất bại (`entitlement_grant.failed`)

Mẹo Tích Hợp