メインコンテンツへスキップ
ソフトウェアまたはデジタル商品のために固有のキーを発行し、アクティベーションを管理し、必要に応じてアクセスを取り消します。ライセンスキーはサブスクリプションや一回きりの購入と相性が良いです。

​
ライセンスキーとは？

ライセンスキーは、製品へのアクセスを認可するユニークなトークンです。以下の用途に最適です：
  • ソフトウェアライセンス: デスクトップアプリ、プラグイン、CLI
  • ユーザーごとの制御: ユーザーまたはデバイスごとのアクティベーションを制限
  • デジタル商品: ダウンロード、アップデート、またはプレミアム機能へのゲート

​
主な利点

  • アクセス制御: 有効期限とアクティベーションの制限を定義
  • 運用の可視性: 使用状況、デバイス、履歴を追跡
  • セキュリティとサポート: 迅速に無効化、再有効化、監査

​
ライセンスキーの作成

1

Create a License Key

Dodo Paymentsダッシュボードにアクセスしてライセンスキーセクションを開きます。新しいライセンスキーを作成するオプションを選択してください。
2

Configure License Key Settings

ライセンスキーの発行と使用方法を次の項目で指定します:
  • License Key Expiry Date: キーが有効な期間を定義します。特定の期間（例えば30日または1年）を選ぶか、「no expiry」を選んで永続的なキーにします。
  • Activation Limit: キーごとの同時アクティベーションの上限を設定します。シングルユーザー（1）やチームライセンス（5）などのケースでは具体的な数値を使い、制限を設けたくない場合は「unlimited」を選びます。
  • Activation Instructions: 顧客向けに明確なアクティベーション手順を記載します。これらはライセンスキーと一緒にメールでも送信されます。例: 「Settings → License にキーを貼り付ける」または「Run: mycli activate <key>」.
3

Review and Save

入力内容をすべて確認します。準備ができたら、ライセンスキーの設定を保存してキーの作成を完了させます。
現実的な指示を使用し、サポートリンクを含めてアクティベーションのチケットを減らします。
Creating a license key in Dodo Payments dashboard

​
管理と監視

ライセンスキーセクションは、すべてのライセンスキーのアクティビティを包括的に表示し、ライセンスを効果的に管理および監視することを可能にします。

​
キー情報

各ライセンスキーの詳細情報を表示します：
  • キーの詳細: ライセンスキーの値、関連する製品名、顧客の詳細（customer_id）、購入日
  • 使用状況: アクティベーションの数、アクティベーションの日付と時刻、ステータス（アクティブ、期限切れ、無効）
  • 有効期限と制限: キーの有効期限、残りのアクティベーション数、現在のアクティベーションインスタンス
License key details

​
利用可能なアクション

ライセンスキーに対して以下のアクションを実行できます：
  • ライセンスキーを無効化: さらなる使用を防ぐためにキーを即座に無効化します
  • キーを有効化: 以前に無効化されたライセンスキーを再有効化します
  • アクティベーションインスタンスを表示: 特定のライセンスキーに関連するすべてのアクティベーションインスタンスを確認します
License key actions

​
利点

  • ライセンスキーのアクティビティをリアルタイムで追跡
  • 潜在的な不正使用や無許可のアクティベーションを特定
  • 不一致が発生した場合に詳細な使用記録を提供することで顧客サポートを簡素化

​
API管理

これらのAPIを使用して、ライセンスキーとそのアクティベーションインスタンスをアクティブ化、検証、リスト、更新します。
Public Endpoints: activate、deactivate、validate ライセンスエンドポイントは public で APIキーを必要としません。これにより、API資格情報を公開せずにクライアントアプリ、デスクトップソフト、CLIから直接呼び出せます。
ライセンスキーに対してアクティベーション、ディアクティベーション、検証操作を実行します。

Activate License

ライセンスキーのアクティベーションインスタンスを作成または記録します。

Deactivate License

容量を空けるために以前のアクティベーションを取り消します。

Validate License

アクセス付与前に正当性、ステータス、制約を確認します。
ライセンスキーとその設定・ステータスを一覧表示、取得、更新します。

List License Keys

すべてのキーとステータス・使用状況の詳細を参照します。

Get License Key

特定のキーとそのメタデータを取得します。

Update License Key

有効期限、アクティベーション上限、またはキーの有効/無効を変更します。
各キーの個別デバイスアクティベーションを操作します。

List Instances

特定のキーに対するすべてのアクティベーションインスタンスを返します。

Get Instance

単一のアクティベーションインスタンスの詳細を取得します。

Update Instance

インスタンスのデバイス情報を取り消すか更新します。

​
統合例

​
ライセンスをアクティブ化

これらのエンドポイントは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: 'license_key', 
  name: 'Device Name' 
});

console.log(response.id);

​
ライセンスを検証

import DodoPayments from 'dodopayments';

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

const response = await client.licenses.validate({ 
  license_key: '2b1f8e2d-c41e-4e8f-b2d3-d9fd61c38f43' 
});

console.log(response.valid);

​
リターンURLのライセンスキー

顧客がライセンスキー対応の商品を購入すると、ライセンスキーがクエリパラメータとして自動的にreturn_urlに追加されます。これにより、追加のAPIコールなしに成功ページですぐにキーを表示できます。 
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com
購入で複数のライセンスキー（例: 数量 > 1）が生成された場合、それらはカンマ区切りになります: 
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com
サブスクリプションでは、subscription_id が payment_id の代わりに使用されます: 
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com
返却ページでlicense_keyパラメータを解析し、購入後の体験を改善するために顧客にすぐにキーを表示します。

​
ベストプラクティス

  • Keep limits clear: 有効期限とアクティベーションに対して妥当なデフォルトを選択する
  • Guide users: 正確なアクティベーション手順とセルフサーブドキュメントを提供する
  • Automate checks: アクセス付与前にサーバー側でキーを検証する
  • Monitor events: Webhook を使って悪用を検出し、取り消しを自動化する
Last modified on February 27, 2026