메인 콘텐츠로 건너뛰기
POST
/
license_keys
JavaScript
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const licenseKey = await client.licenseKeys.create({
  customer_id: 'customer_id',
  key: 'key',
  product_id: 'product_id',
});

console.log(licenseKey.id);
{
  "business_id": "<string>",
  "created_at": "2024-01-01T00:00:00Z",
  "customer_id": "cus_123",
  "id": "lic_123",
  "instances_count": 123,
  "key": "<string>",
  "product_id": "<string>",
  "source": "auto",
  "status": "active",
  "activations_limit": 5,
  "expires_at": "2024-12-31T23:59:59Z",
  "payment_id": "<string>",
  "subscription_id": "<string>"
}
API를 통해 생성되거나 업데이트된 라이선스 키는 고객에게 이메일 알림을 트리거하지 않습니다. 라이선스 키에 대해 고객에게 알리려면 애플리케이션에서 이를 별도로 처리해야 합니다.

인증

​
Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문

application/json
​
customer_id
string
필수

The customer this license key belongs to.

​
key
string
필수

The license key string to import.

​
product_id
string
필수

The product this license key is for.

​
activations_limit
integer<int32> | null

Maximum number of activations allowed. Null means unlimited.

​
expires_at
string<date-time> | null

Expiration timestamp. Null means the key never expires.

응답

License key created

​
business_id
string
필수

The unique identifier of the business associated with the license key.

​
created_at
string<date-time>
필수

The timestamp indicating when the license key was created, in UTC.

예시:

"2024-01-01T00:00:00Z"

​
customer_id
string
필수

The unique identifier of the customer associated with the license key.

예시:

"cus_123"

​
id
string
필수

The unique identifier of the license key.

예시:

"lic_123"

​
instances_count
integer<int32>
필수

The current number of instances activated for this license key.

​
key
string
필수

The license key string.

​
product_id
string
필수

The unique identifier of the product associated with the license key.

​
source
enum<string>
필수

The source of the license key - 'auto' for keys generated by payment/subscription flows, 'import' for merchant-imported keys.

사용 가능한 옵션:
auto,
import
​
status
enum<string>
필수

The current status of the license key (e.g., active, inactive, expired).

사용 가능한 옵션:
active,
expired,
disabled
​
activations_limit
integer<int32> | null

The maximum number of activations allowed for this license key.

예시:

5

​
expires_at
string<date-time> | null

The timestamp indicating when the license key expires, in UTC.

예시:

"2024-12-31T23:59:59Z"

​
payment_id
string | null

The unique identifier of the payment associated with the license key, if any.

​
subscription_id
string | null

The unique identifier of the subscription associated with the license key, if any.

Last modified on April 20, 2026