Dodo Payments のリソースを管理し、アカウントに対して AI 対応クエリを実行し、チェックアウトセッションを作成し、Webhook をテストします — すべてターミナルから実行可能です。CLI にはインタラクティブな TUI、MCP によって駆動される組み込み AI アシスタント、オフラインでの Webhook テストが含まれています。
- インタラクティブな TUI — コマンドパレット、履歴、ライブ通知を備えたフルインタラクティブインターフェースを開くには、引数なしで
dodo を起動します。
- 組み込み AI アシスタント —
/ai を使用して、プレーンな英語で質問やアクションを実行します。追加のセットアップは不要で、dodopayments-mcp がローカルで実行されます。
- デフォルトで安全 — API キーは OS の秘密ストア (macOS キーチェーン、Windows Credential Vault、Linux libsecret) に保存されます。ディスク上にプレーンテキストの設定はありません。
- 自動アップデート — CLI は起動時に新しいバージョンをチェックし、アプリ内で通知します。
/update を実行してその場でアップグレードできます。
- Webhook ツール — ライブ Webhook のリッスンまたはローカル開発用にオフラインでペイロードをトリガーします。
インストール
macOS または Linux で CLI をワンライナーでインストールします:
curl -fsSL https://dodopayments.com/install.sh | sh
npm または Bun を使用してインストール
すでに Node または Bun をお持ちの場合、パッケージマネージャーのインストールは常に最新バージョンを取得します:
npm install -g dodopayments-cli
手動インストール (Node / Bun は不要)
リモートスクリプトを sh にパイプするのが嫌な場合は、バイナリを自分でダウンロードしてください。
Download the binary
最新の GitHub Release からプラットフォーム用のバイナリをダウンロードします。| プラットフォーム | バイナリ |
|---|
| macOS (Apple Silicon) | dodo-cli-darwin-arm64 |
| macOS (Intel) | dodo-cli-darwin-x64 |
| Linux (x86_64) | dodo-cli-linux-x64 |
| Linux (arm64) | dodo-cli-linux-arm64 |
| Windows (x86_64) | dodo-cli-windows-x64.exe |
Rename the binary to `dodo`
mv ./dodo-cli-* ./dodo && chmod +x ./dodo
Move it to a directory on your PATH
sudo mv ./dodo /usr/local/bin/
Windows では、C:\Windows\System32 に移動するには管理者権限が必要です。
(Optional) Verify the download
各リリースには SHA256SUMS.txt が公開されます。ダウンロードを確認するには:shasum -a 256 -c SHA256SUMS.txt
- Dodo Payments API キーのページをブラウザで開く。
- API キーを貼り付けるように求められる。
- 環境を選択するように求められる — テストモード または ライブモード。
- 資格情報が OS の秘密ストアに保存される (macOS のキーチェーン、Windows の Credential Vault、Linux の libsecret)。
資格情報は OS の秘密ストアに保存されるため、CLI が資格情報を読み書きする最初の時に デバイスパスワード を求められることがあります。古いバージョンからアップグレードする場合、既存のプレーンテキスト API キーは秘密ストアに移行され、レガシーファイルは自動的に削除されます。
モードの切り替えとログアウト
1 つの テストモード と 1 つの ライブモード キーを同時に認証したままにできます。資格情報をクリアするには:
ログアウトフローでは、すべてのアカウント、テストモード、または ライブモード を独立して選択できます。
使用方法
CLI は 2 つのモードで使用できます。
1. インタラクティブな TUI (推奨)
引数なしで dodo を実行し、フルインタラクティブインターフェースを起動します:
/ を入力してコマンドパレットを開くか、単に入力を開始します — スラッシュコマンドでないものはすべて AI アシスタントに送信されます。
| コマンド | 説明 |
|---|
/help | コマンドリファレンスを表示 |
/update | CLI の更新をチェックしてインストール |
/login | API キーで認証 |
/logout | 1 つまたはすべての環境からサインアウト |
/clear | TUI 画面をクリア |
/exit | TUI を終了 (または: exit と入力、Esc を 2 回押す) |
2. 直接サブコマンド
TUI に入らずに直接コマンドを実行します:
dodo <category> <sub-command> [args...]
dodo payments list 1
dodo customers create
dodo wh trigger
/ を付け、直接モードでは / を省略します。
AI アシスタント
自然言語で質問をしたりアクションを実行します。アシスタントはローカルで実行される dodopayments-mcp を使用しています — 追加の設定や OAuth フローは不要で、AI トラフィックはモデルプロバイダとの通信を除いてマシンを離れません。
| コマンド | 説明 |
|---|
/ai <query> | AI アシスタントに質問をしたり指示を与えたりする |
| (スラッシュコマンドではない任意のテキスト) | TUI 内にいる間はデフォルトで AI アシスタントに送信されます |
how much revenue did I make this week?
/ai create a new customer named Acme Inc.
/ai find my last failed payment
アシスタントはアクティブな環境 (テスト / ライブ) を尊重し、現在ログインしている環境のデータにのみ操作します。
コマンドリファレンス
製品カタログを管理します。
| コマンド | 説明 |
|---|
dodo products list <page> | 製品を一覧表示 |
dodo products create | ダッシュボードを開いて製品を作成 |
dodo products info <id> | 特定の製品の詳細を表示 |
支払い
支払いトランザクションを見る。
| コマンド | 説明 |
|---|
dodo payments list <page> | 支払いを一覧表示 |
dodo payments info <id> | 特定の支払いに関する情報を取得 |
| コマンド | 説明 |
|---|
dodo customers list <page> | 顧客を一覧表示 |
dodo customers create | 新しい顧客を作成 |
dodo customers update <id> | 既存の顧客の更新 |
| コマンド | 説明 |
|---|
dodo discounts list <page> | 割引を一覧表示 |
dodo discounts create | 新しい割合ベースの割引を作成 |
dodo discounts delete <id> | ID で割引を削除 |
ライセンス
ソフトウェアライセンスを管理します。
| コマンド | 説明 |
|---|
dodo licences list <page> | ライセンスを一覧表示 |
アドオン
製品のアドオンを管理します。
| コマンド | 説明 |
|---|
dodo addons list <page> | アドオンを一覧表示 |
dodo addons create | ダッシュボードを開いてアドオンを作成 |
dodo addons info <id> | 特定のアドオンの詳細を表示 |
| コマンド | 説明 |
|---|
dodo refunds list <page> | 返金を一覧表示 |
dodo refunds info <id> | 特定の返金の詳細を表示 |
チェックアウト
ホストされたチェックアウトセッションを作成します。
| コマンド | 説明 |
|---|
dodo checkout new | インタラクティブにホストされたチェックアウトセッションを作成し、支払いリンクを取得 |
Webhooks
CLI には、開発中の Webhook テストのための 2 つの強力なツールが含まれています: ライブテスト Webhook をローカルサーバーに転送する リスナー と、任意のエンドポイントにモック Webhook ペイロードを送信する トリガー。
| コマンド | 説明 |
|---|
dodo wh listen | リアルタイムで Webhook をリッスンし、それをローカルの開発サーバーに転送 |
dodo wh trigger | ログアウト中でさえもインタラクティブにテスト Webhook イベントをトリガー |
Webhook をリッスン
Dodo Payments からの Webhook をリアルタイムで直接ローカル開発サーバーに転送します。
Enter your local endpoint URL
リッスンしたい Webhook のローカル URL を提供します (例: http://localhost:3000/webhook)。
Automatic setup
CLI は、Dodo Payments アカウント上に Webhook エンドポイントが存在しない場合は自動的に作成し、その後イベントをリアルタイムで受信するための WebSocket 接続を開きます。
Receive and forward
Webhook イベントが発生したとき (テスト支払い、サブスクリプション変更など)、CLI はそれを受信し、イベントタイプをログに記録し、ヘッダとボディを含む完全なリクエストをローカルエンドポイントに転送します。エンドポイントからの応答はログに記録され、返送されます。
dodo wh listen には テストモード API キーが必要です。ライブモードのキーはリッスンフローでサポートされていません。
リスナーは、あなたのローカルエンドポイントに転送するときに元の Webhook ヘッダー (webhook-id、webhook-signature、webhook-timestamp) を保持しているため、署名検証ロジックをテストできます。
テスト Webhook をトリガー
リアルなトランザクションを作成することなく、迅速にテストするために任意のエンドポイントにモック Webhook ペイロードを送信します。
/wh trigger フローで以下を案内します:
- 送信先 エンドポイント URL の設定
- インタラクティブメニューからトリガーする特定の イベント を選択
dodo wh trigger はログインを必要としない ローカル/オフライン Webhook ペイロードジェネレーターとして機能します。
トリガーされたイベントは 署名されていません。テスト中は、Webhook 署名検証をエンドポイントで無効にしてテストしてください — 例として、テスト中は unsafe_unwrap() を使用し、 unwrap() ではないものを Webhook ハンドラに指定します。
サポートされる Webhook イベント
| カテゴリ | イベント |
|---|
| サブスクリプション | active、updated、on_hold、renewed、plan_changed、cancelled、failed、expired |
| 支払い | succeeded、failed、processing、cancelled |
| 返金 | succeeded、failed |
| 紛争 | opened、expired、accepted、cancelled、challenged、won、lost |
| ライセンス | created |
環境変数
| 変数 | 説明 |
|---|
DODO_WH_TEST_SERVER_URL | dodo wh listen が使用するデフォルトの Webhook リレーサーバー URL を上書き |
アップデート
CLI は起動時に新しいバージョンをチェックし、新しいものがある場合、ステータスバーに通知を表示します。アップグレードするには:
または、インストーラーを再実行してその場でアップグレードします:
curl -fsSL https://dodopayments.com/install.sh | sh
リソース
GitHub Repository
ソースコードとリリースを表示
サポート
