License Keys

​

라이선스 키란 무엇인가요?

• Software licensing: 데스크톱 앱, 플러그인 및 CLI.
• Per-seat controls: 사용자 또는 디바이스별 활성화를 제한합니다.
• Digital goods: 다운로드, 업데이트 또는 프리미엄 기능에 대한 액세스를 제어합니다.

​

Create a License Key Entitlement

1

Open Entitlements

대시보드에서 Entitlements로 이동하고 **+**를 클릭하여 entitlement를 생성합니다.

2

Choose License Key

License Keys를 선택하고 Name을 입력한 다음, 발급되는 각 키의 동작을 구성합니다:

• Fulfillment Mode: Automatic(기본값)은 각 키를 생성하고 이메일로 전송합니다. Manual을 사용하면 각 키를 직접 제공할 수 있습니다. Manual Fulfillment를 참조하세요.
• Activations Limit: 키당 활성화할 수 있는 최대 활성화 수입니다. 예를 들어 단일 사용자는 1, 팀 라이선스는 5입니다. 제한이 없으면 Unlimited를 선택하세요.
• License Length: 키가 발급된 후 유효한 기간입니다. 예를 들어 30일 또는 1년을 설정하거나 No expiration을 선택할 수 있습니다. subscription 제품에서는 No expiration을 선택하세요. subscription에 발급된 키에는 만료 기간이 없으며, 유효성은 subscription 상태를 따릅니다.
• Activation Message: 고객에게 표시되는 선택적 안내로, 최대 2,500자이며 키를 전달하는 이메일에 포함됩니다. 예: Paste the key in Settings → License 또는 Run: mycli activate <key>.

3

Save the Entitlement

Create Entitlement를 클릭합니다. 이제 모든 제품에 entitlement를 연결할 수 있습니다.

​

Attach to Products

​

How Keys Are Issued

​

수량 동작

• Subscription products는 seat당 키 하나를 발급합니다(subscriptions.quantity).
• One-time products는 cart line item의 수량당 키 하나를 발급합니다(product_cart.quantity).
• Manual API grants는 정확히 하나의 키를 발급합니다.

​

Fulfillment Mode

• auto(기본값, 대시보드의 Automatic): Dodo Payments가 결제 또는 subscription 시 키를 생성하고 이메일로 전송합니다. 위 표의 동작이며 fulfillment_mode를 생략하면 적용됩니다.
• manual(대시보드의 Manual): 구매한 각 수량마다 키가 없는 Pending grant가 생성되며, 각 키 값을 직접 제공합니다. Manual Fulfillment를 참조하세요.

​

Manual Fulfillment

​

사용 시점

• Bring your own keys: 애플리케이션, 데스크톱 제품 또는 자체 license server가 키를 생성합니다.
• Third-party vendors: upstream provider가 발급한 키를 재판매합니다. 예를 들어 game key, API credential 또는 partner platform license가 있습니다.
• Finite inventory: 사전 할당된 pool의 코드를 한 번에 하나씩 제공합니다.
• Human review: 액세스를 제공하기 전에 구매를 검토합니다.

​

Manual Fulfillment 활성화

// `client` is a DodoPayments instance created with your API key.
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',
  },
});

curl -X POST https://test.dodopayments.com/entitlements \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro License (Manual)",
    "integration_type": "license_key",
    "integration_config": {
      "fulfillment_mode": "manual",
      "activations_limit": 5,
      "duration_count": 1,
      "duration_interval": "Year"
    }
  }'

​

Fulfillment 대기 중인 Grant 찾기

const pending = await client.customers.listEntitlementGrants('cus_abc123', {
  integration_type: 'license_key',
  status: 'Pending',
});

​

키 전달

curl -X POST https://test.dodopayments.com/grants/entg_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"
  }'

​

활성화, 검증 및 비활성화

​

라이선스 활성화

import DodoPayments from 'dodopayments';

// The license endpoints don't check the token, but the SDK requires a value.
// Never ship your secret API key in client software.
const client = new DodoPayments({ bearerToken: 'public', environment: 'test_mode' });

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

console.log(response.id);

from dodopayments import DodoPayments

# The license endpoints don't check the token, but the SDK requires a value.
client = DodoPayments(bearer_token="public", environment="test_mode")

response = client.licenses.activate(
    license_key="PRO-AAAA-BBBB-CCCC-DDDD",
    name="Device Name",
)
print(response.id)

curl -X POST https://test.dodopayments.com/licenses/activate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "name": "Device Name"
  }'

​

라이선스 검증

// Uses the client from the activation example.
const response = await client.licenses.validate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
});

console.log(response.valid);

curl -X POST https://test.dodopayments.com/licenses/validate \
  -H "Content-Type: application/json" \
  -d '{ "license_key": "PRO-AAAA-BBBB-CCCC-DDDD" }'

​

Activation Instance 비활성화

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

​

키 관리

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);
}

​

API를 통한 기존 라이선스 키 가져오기

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

​

출처에 따른 키 차이

​

Return URL의 라이선스 키

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%2CLK-002&email=customer%40example.com

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

​

API 관리

​

Webhooks

​

Legacy License Keys

​

Best Practices

• 명확한 활성화 제한 선택: 단일 사용자 앱에는 1, 팀 라이선스에는 3–5와 같은 기본값을 선택하고 고객에게 문서로 안내하세요.
• 정확한 활성화 메시지 작성: 고객은 라이선스 키 이메일에서 메시지를 복사하므로 정확한 path와 command를 제공하면 support ticket을 줄일 수 있습니다.
• API에 대해 키 검증: network-connected 제품에서는 로컬에 캐시된 활성화에 의존하지 말고 /licenses/validate를 호출하세요.
• revoke에 webhook 사용: 고객이 취소하거나 환불을 받았을 때 앱 내 기능을 비활성화하도록 entitlement_grant.revoked를 처리하세요.
• subscription 및 one-time purchase 테스트: 둘 사이에서 라이선스 키 동작이 다릅니다. 예를 들어 subscription 키는 만료되지 않으므로 출시 전에 두 경우를 모두 테스트하세요.