License Keys

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Mã Giấy Phép là gì?

• Software licensing: Desktop apps, plugins, and CLIs
• Per-seat controls: Limit activations per user or device
• Digital goods: Gate downloads, updates, or premium features

​

Tạo một Quyền cấp phép License Key

1

Open Entitlements

Đi đến Entitlements trong bảng điều khiển Dodo Payments của bạn và nhấp + để tạo một quyền mới.

2

Choose License Key

Chọn License Key làm tích hợp. Cấu hình cách mà mỗi mã được cấp phát hành xử lý:

• Giới hạn Kích hoạt: Số lượng kích hoạt đồng thời tối đa cho mỗi mã (ví dụ, 1 cho ứng dụng một người dùng, 5 cho giấy phép nhóm, để trống cho không giới hạn).
• Thời Gian: Thời gian mã duy trì hiệu lực sau khi phát hành (ví dụ, 30 ngày, 1 năm). Đối với mã được cấp phát hành thông qua đăng ký, để trống; mã vẫn có hiệu lực miễn là đăng ký còn hoạt động.
• Hướng Dẫn Kích Hoạt: Các hướng dẫn dành cho khách hàng được gửi kèm với mã qua email. Ví dụ: Paste the key in Settings → License hoặc Run: mycli activate <key>.

3

Save the entitlement

Lưu. Quyền cấp phát hành giờ có sẵn để gắn vào bất kỳ sản phẩm nào.

​

Gắn vào Sản Phẩm

​

Cách Mã Được Phát Hành

​

Hành vi với Số lượng

• Sản phẩm đăng ký cấp một mã cho mỗi chỗ (subscriptions.quantity).
• Sản phẩm một lần cấp một mã cho mỗi dòng sản phẩm trong giỏ hàng (product_cart.quantity).
• Cấp phát thủ công qua API chỉ cấp đúng một mã.

​

Kích hoạt, Xác thực, Hủy kích hoạt

​

Kích hoạt giấy phép

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.activate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  name: 'Device Name',
});

console.log(response.id);

​

Xác thực giấy phép

const response = await client.licenses.validate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
});

console.log(response.valid);

​

Hủy kích hoạt một phiên bản kích hoạt

await client.licenses.deactivate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  license_key_instance_id: 'instance_abc123',
});

​

Quản lý Mã

const grants = await client.entitlements.grants.list('ent_license_key_id', {
  status: 'delivered',
});

for (const grant of grants.items) {
  console.log(grant.license_key.key, grant.license_key.activations_used);
}

​

Nhập Mã Giấy Phép Hiện Có qua API

const licenseKey = await client.licenseKeys.create({
  customer_id: 'cus_abc123',
  product_id: 'prod_456',
  key: 'YOUR-EXISTING-LICENSE-KEY',
  activations_limit: 5,
  expires_at: '2026-12-31T23:59:59Z',
});

​

Khác biệt của mã đã nhập từ mã tự động tạo

​

Mã Giấy Phép trong URL Trả Về

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com

https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com

​

Quản Lý API

​

Webhooks

​

Mã Giấy Phép Cũ

​

Thực Hành Tốt Nhất

• Giữ rõ ràng các giới hạn kích hoạt: Chọn các mặc định hợp lý (1 cho ứng dụng một người dùng, 3–5 cho giấy phép nhóm) và tài liệu hóa chúng.
• Cung cấp hướng dẫn kích hoạt chính xác: Khách hàng sẽ dán chúng từ email của họ, vì vậy các đường dẫn và lệnh chính xác sẽ tiết kiệm các yêu cầu hỗ trợ.
• Xác thực mã phía máy chủ: Đối với các sản phẩm kết nối mạng, hãy xác thực qua /licenses/validate thay vì lưu trữ tạm thời kích hoạt cục bộ.
• Sử dụng webhooks để thu hồi: Nghe entitlement_grant.revoked để vô hiệu hóa các tính năng trong ứng dụng ngay lập tức khi khách hàng hủy hoặc hoàn tiền.
• Kiểm tra với các đăng ký và mục tiêu đơn lẻ: Hành vi của mã giấy phép có sự khác biệt tinh tế giữa hai loại, vì vậy hãy thử nghiệm cả hai trước khi hoạt động.