License Keys

​

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ã.

​

Chế độ thực hiện

• auto (mặc định): Dodo Payments tự động tạo và gửi qua email mã khi thanh toán hoặc đăng ký. Đây là hành vi đã mô tả trước đó và áp dụng khi fulfillment_mode bị bỏ qua.
• manual: Việc mua tạo ra một quyền cấp pending không có mã, và bạn tự cung cấp từng giá trị mã. Xem Thực hiện thủ công dưới đây.

​

Thực hiện thủ công

​

Khi nào sử dụng

• Mang theo mã của bạn: Mã được tạo bởi ứng dụng của bạn, một sản phẩm desktop, hoặc máy chủ cấp phép của bạn.
• Nhà cung cấp bên thứ ba: Bạn bán lại các mã được cấp bởi nhà cung cấp thượng nguồn (một mã game, thông tin xác thực API, nền tảng đối tác).
• Tồn kho hữu hạn: Bạn cung cấp mã từ một nhóm đã phân bổ trước và muốn chỉ định chúng từng cái một.
• Đánh giá con người: Bạn muốn xem xét một giao dịch mua trước khi phát hành quyền truy cập.

​

Kích hoạt thực hiện thủ công

const entitlement = await client.entitlements.create({
  name: 'Pro License (Manual)',
  integration_type: 'license_key',
  integration_config: {
    fulfillment_mode: 'manual',
    activations_limit: 5,
    duration_count: 1,
    duration_interval: 'Year',
  },
});

​

Tìm quyền cấp chờ thực hiện

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

​

Cung cấp mã

curl -X POST https://test.dodopayments.com/grants/grant_8VbC6JDZ/license-key \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "activations_limit": 5,
    "expires_at": "2027-05-01T00:00:00Z"
  }'

​

Kích hoạt, Xác nhận, Hủy kích hoạt

​

Kích hoạt một license

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 nhận một license

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ã License Hiện Tại 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',
});

​

Sự Khác Biệt của Mã theo Nguồn

​

Mã License 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ã License Cũ

​

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

• Giữ giới hạn kích hoạt rõ ràng: Chọn các giá trị mặc định hợp lý (1 cho ứng dụng đơn 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 dán những hướng dẫn này 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 nhận mã phía máy chủ: Đối với các sản phẩm kết nối mạng, xác nhận qua /licenses/validate thay vì lưu trữ dữ liệu kích hoạt cục bộ.
• Sử dụng webhooks để thu hồi: Lắng 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 đăng ký và một lần: Hành vi mã license khác biệt nhẹ giữa hai hình thức, vì vậy hãy kiểm tra cả hai trước khi đưa vào thực tế.