라이센스 키

​

라이선스 키란?

• 소프트웨어 라이센스: 데스크탑 앱, 플러그인 및 CLI
• 사용자당 제어: 사용자 또는 장치당 활성화 제한
• 디지털 상품: 다운로드, 업데이트 또는 프리미엄 기능에 대한 접근 제한

​

라이선스 키 사용 권한 생성

1

Open Entitlements

Dodo Payments 대시보드에서 Entitlements로 이동하여 **+**를 클릭하여 새 사용 권한을 생성합니다.

2

Choose License Key

License Key를 통합으로 선택하십시오. 발급된 각 키가 작동하는 방식을 구성합니다:

• 활성화 제한: 키당 최대 동시 활성화 (예: 단일 사용자용 1, 팀 라이선스용 5, 무제한은 비워둡니다).
• 기간: 발급 후 키가 유효한 기간 (예: 30일, 1년). 구독용 키의 경우 비워두십시오; 구독이 활성 상태로 유지되는 한 키는 유효합니다.
• 활성화 지침: 키와 함께 이메일로 전송되는 고객용 지침. 예: Paste the key in Settings → License 또는 Run: mycli activate <key>.

3

Save the entitlement

저장합니다. 이제 사용 권한은 모든 제품에 첨부할 수 있습니다.

​

제품에 첨부

​

키 발급 방법

​

수량 동작

• 구독 제품은 시트당 하나의 키를 발급합니다 (subscriptions.quantity).
• 일회성 제품은 장바구니 항목당 하나의 키를 발급합니다 (product_cart.quantity).
• 수동 API 부여는 정확히 하나의 키를 발급합니다.

​

활성화, 검증, 비활성화

​

라이선스 활성화

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

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

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"
  }'

​

라이선스 검증

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" }'

​

활성화 인스턴스 비활성화

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

​

키 관리

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

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: 'prod_456',
  key: 'YOUR-EXISTING-LICENSE-KEY',
  activations_limit: 5,
  expires_at: '2026-12-31T23:59:59Z',
});

​

가져온 키와 자동 생성 키의 차이

​

반품 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,LK-002&email=customer%40example.com

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

​

API 관리

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

​

웹훅

​

레거시 라이선스 키

​

모범 사례

• 활성화 제한을 명확히 유지: 합리적인 기본값(단일 사용자 앱의 경우 1, 팀 라이선스의 경우 3–5)을 선택하고 이를 문서화합니다.
• 정확한 활성화 지침 제공: 고객이 이메일에서 복사하여 붙여넣기 때문에 정확한 경로와 명령은 지원 티켓을 절약합니다.
• 서버 측에서 키 검증: 네트워크 연결된 제품의 경우 로컬 활성화를 캐시하기보다는 /licenses/validate를 통해 검증합니다.
• 해지 시 웹훅 사용: 고객이 취소하거나 환불할 때 즉시 앱 내 기능을 비활성화하려면 entitlement_grant.revoked를 듣습니다.
• 구독 및 일회성 제품을 테스트: 라이선스 키 동작은 두 제품 간에 미묘하게 다르므로, 라이브로 전환하기 전에 둘 다 테스트합니다.

​

API Management

​

Webhooks

​

Legacy License Keys

​

Best Practices

• 활성화 제한을 명확하게 유지하세요: 적절한 기본값을 선택하세요(단일 사용자 앱은 1, 팀 라이선스는 3–5) 그리고 이를 문서화하세요.
• 정확한 활성화 지침을 제공하세요: 고객은 이메일에서 이를 복사하므로, 정확한 경로 및 명령은 지원 요청을 줄여줍니다.
• 서버 측에서 키를 검증하세요: 네트워크 연결 제품의 경우, 로컬에서 활성화를 캐시하는 것보다 /licenses/validate를 통해 검증하세요.
• 취소를 위해 웹훅을 사용하세요: 고객이 취소하거나 환불할 때 entitlement_grant.revoked를 듣고 앱 기능을 즉시 비활성화하세요.
• 구독과 일회성 테스트를 하세요: 라이센스 키 동작은 두 경우에서 미묘하게 다르므로 라이브 전에 둘 다 테스트하세요.