Dodo CLI

Kelola resource Dodo Payments, jalankan kueri bertenaga AI terhadap akun Anda, buat checkout session, dan uji webhook — semuanya dari terminal. CLI ini dilengkapi TUI interaktif, asisten AI bawaan yang didukung MCP, serta pengujian webhook offline.

Fitur

TUI interaktif — jalankan dodo tanpa argumen untuk membuka antarmuka interaktif lengkap dengan palet perintah, riwayat, dan notifikasi langsung.
Asisten AI bawaan — ajukan pertanyaan atau lakukan tindakan dalam bahasa sehari-hari dengan /ai. Tidak memerlukan pengaturan tambahan dan berjalan dodopayments-mcp secara lokal.
Aman secara default — API key disimpan di penyimpanan rahasia OS Anda (macOS Keychain, Windows Credential Vault, Linux libsecret). Tidak ada konfigurasi plaintext di disk.
Pembaruan otomatis — CLI memeriksa versi baru saat startup dan memberi tahu Anda di dalam aplikasi. Jalankan /update untuk memperbarui secara langsung.
Perangkat webhook — dengarkan webhook langsung atau picu payload secara offline untuk pengembangan lokal.

Instalasi

Instal CLI dalam satu baris di macOS atau Linux:

curl -fsSL https://dodopayments.com/install.sh | sh

Instal dengan npm atau Bun

Jika Anda sudah memiliki Node atau Bun, instalasi melalui package manager selalu mengambil versi terbaru:

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Instalasi manual (tidak memerlukan Node / Bun)

Jika Anda tidak ingin menyalurkan skrip remote ke sh, unduh binary-nya sendiri.

Download the binary

Unduh binary untuk platform Anda dari GitHub Release terbaru.

Platform	Binary
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

ren .\dodo-cli-windows-x64.exe .\dodo.exe

Move it to a directory on your PATH

sudo mv ./dodo /usr/local/bin/

move .\dodo.exe C:\Windows\System32\dodo.exe

Di Windows, memindahkan ke C:\Windows\System32 memerlukan hak administrator.

(Optional) Verify the download

Setiap rilis menerbitkan SHA256SUMS.txt. Verifikasi unduhan Anda dengan:

shasum -a 256 -c SHA256SUMS.txt

Autentikasi

Sebelum menggunakan perintah yang memerlukan autentikasi, masuk dengan API key Anda:

dodo login

Atau, dari dalam TUI interaktif:

/login

Alur login akan:

Membuka browser Anda ke halaman API Keys Dodo Payments.
Meminta Anda menempelkan API Key.
Meminta Anda memilih environment — Test Mode atau Live Mode.
Menyimpan kredensial di penyimpanan rahasia OS Anda (Keychain di macOS, Credential Vault di Windows, libsecret di Linux).

Karena kredensial disimpan di penyimpanan rahasia OS, Anda mungkin diminta memasukkan kata sandi perangkat saat pertama kali CLI membaca atau menulis kredensial. Jika Anda melakukan upgrade dari versi lama, API key plaintext yang ada akan dimigrasikan ke penyimpanan rahasia dan file lama dihapus secara otomatis.

Beralih mode dan logout

Anda dapat mengautentikasi satu key Test Mode dan satu key Live Mode secara bersamaan. Untuk menghapus kredensial:

dodo logout

/logout

Alur logout memungkinkan Anda memilih antara All accounts, Test Mode, atau Live Mode secara terpisah.

Penggunaan

Anda dapat menggunakan CLI dalam dua mode.

1. TUI interaktif (disarankan)

Jalankan dodo tanpa argumen untuk membuka antarmuka interaktif lengkap:

dodo

Ketik / untuk membuka palet perintah, atau langsung mulai mengetik — apa pun yang bukan perintah slash akan dikirim ke asisten AI.

Command	Description
`/help`	Menampilkan referensi perintah
`/update`	Memeriksa dan menginstal pembaruan CLI
`/login`	Melakukan autentikasi dengan API key
`/logout`	Logout dari satu atau semua environment
`/clear`	Menghapus layar TUI
`/exit`	Keluar dari TUI (juga: ketik `exit`, atau tekan `Esc` dua kali)

2. Subperintah langsung

Jalankan perintah secara langsung tanpa masuk ke TUI:

dodo <category> <sub-command> [args...]

Contoh:

dodo payments list 1
dodo customers create
dodo wh trigger

Tabel referensi di bawah menampilkan semua perintah. Di TUI, awali dengan /; dalam mode langsung, hilangkan /.

Asisten AI

Ajukan pertanyaan atau lakukan tindakan dalam bahasa alami. Asisten menggunakan dodopayments-mcp yang berjalan secara lokal — tidak memerlukan pengaturan tambahan atau alur OAuth, dan traffic AI Anda tidak meninggalkan mesin kecuali untuk berkomunikasi dengan penyedia model.

Command	Description
`/ai <query>`	Ajukan pertanyaan atau berikan instruksi kepada asisten AI
(any non-slash text)	Secara default dikirim ke asisten AI saat berada di TUI

Contoh:

how much revenue did I make this week?
/ai create a new customer named Acme Inc.
/ai find my last failed payment

Asisten mengikuti environment aktif Anda (Test / Live), sehingga hanya beroperasi pada data dari environment tempat Anda sedang login.

Pembuatan Struktur Proyek

dodo init membuat struktur route billing Dodo Payments langsung ke dalam proyek yang sudah ada. Perintah ini menghasilkan file route boilerplate, menginstal package adapter @dodopayments/* yang sesuai, dan menulis environment variable DODO_PAYMENTS_* dengan aman ke .env Anda (hanya menambahkan variable yang belum ada). Perintah ini berjalan tanpa login.

dodo init <framework>

Scaffold	Description
`dodo init nextjs`	Membuat struktur route billing Next.js App Router (checkout, customer portal, dan webhook handler) menggunakan `@dodopayments/nextjs`
`dodo init express`	Membuat struktur route billing server Express menggunakan `@dodopayments/express`
`dodo init better-auth`	Membuat struktur konfigurasi plugin Better-Auth menggunakan `@dodopayments/better-auth`

Untuk scaffold Better-Auth, Anda dapat meneruskan daftar plugin yang dipisahkan koma untuk dibuat (default-nya semua): checkout, portal, usage, webhooks.

# Scaffold every Better-Auth plugin (default)
dodo init better-auth

# Scaffold only specific plugins
dodo init better-auth checkout,portal

Scaffolder secara otomatis mendeteksi direktori src/ dan menyesuaikan path output, serta mendeteksi package manager Anda (bun, pnpm, yarn, atau npm) untuk menjalankan perintah instalasi yang benar.

Referensi Perintah

Produk

Kelola katalog produk Anda.

Command	Description
`dodo products list <page>`	Menampilkan daftar produk
`dodo products create`	Membuka dashboard untuk membuat produk
`dodo products info <id>`	Menampilkan detail produk tertentu

Pembayaran

Menampilkan transaksi pembayaran.

Command	Description
`dodo payments list <page>`	Menampilkan daftar pembayaran
`dodo payments info <id>`	Mendapatkan informasi tentang pembayaran tertentu

Customer

Kelola basis customer Anda.

Command	Description
`dodo customers list <page>`	Menampilkan daftar customer
`dodo customers create`	Membuat customer baru
`dodo customers update <id>`	Memperbarui customer yang sudah ada

Diskon

Kelola kupon dan diskon.

Command	Description
`dodo discounts list <page>`	Menampilkan daftar diskon
`dodo discounts create`	Membuat diskon berbasis persentase baru
`dodo discounts delete <id>`	Menghapus diskon berdasarkan ID

Lisensi

Kelola lisensi software.

Command	Description
`dodo licences list <page>`	Menampilkan daftar lisensi

Addon

Kelola addon produk.

Command	Description
`dodo addons list <page>`	Menampilkan daftar addon
`dodo addons create`	Membuka dashboard untuk membuat addon
`dodo addons info <id>`	Menampilkan detail addon tertentu

Refund

Menampilkan informasi refund.

Command	Description
`dodo refunds list <page>`	Menampilkan daftar refund
`dodo refunds info <id>`	Menampilkan detail refund tertentu

Checkout

Membuat checkout session yang di-host.

Command	Description
`dodo checkout new`	Membuat checkout session yang di-host secara interaktif dan mendapatkan payment link

Webhook

CLI menyertakan dua perangkat canggih untuk menguji webhook selama pengembangan: listener yang meneruskan webhook test langsung ke server lokal Anda, dan trigger yang mengirim payload webhook tiruan ke endpoint mana pun.

Command	Description
`dodo wh listen`	Mendengarkan webhook secara real time dan meneruskannya ke server dev lokal Anda
`dodo wh trigger`	Memicu event webhook test secara interaktif — bahkan saat logout

Mendengarkan webhook

Teruskan webhook dari Dodo Payments langsung ke server pengembangan lokal Anda secara real time.

dodo wh listen

Enter your local endpoint URL

Berikan URL lokal tempat Anda ingin menerima webhook (misalnya, http://localhost:3000/webhook).

Automatic setup

CLI secara otomatis membuat endpoint webhook di akun Dodo Payments Anda jika belum ada, lalu membuka koneksi WebSocket untuk menerima event secara real time.

Receive and forward

Saat event webhook terpicu (dari pembayaran test, perubahan subscription, dan sebagainya), CLI menerimanya, mencatat tipe event, lalu meneruskan request lengkap beserta header dan body ke endpoint lokal Anda. Respons dari endpoint Anda dicatat dan dikirim kembali.

dodo wh listen memerlukan API key Test Mode. Key Live Mode tidak didukung oleh alur listen.

Listener mempertahankan header webhook asli (webhook-id, webhook-signature, webhook-timestamp) saat meneruskannya ke endpoint lokal Anda, sehingga Anda dapat menguji logika verifikasi signature.

Memicu webhook test

Kirim payload webhook tiruan ke endpoint mana pun untuk pengujian cepat tanpa perlu membuat transaksi nyata.

dodo wh trigger

Alur /wh trigger memandu Anda melalui:

Menetapkan URL endpoint tujuan
Memilih event tertentu untuk dipicu dari menu interaktif

dodo wh trigger tidak memerlukan login. Perintah ini berfungsi sebagai generator payload webhook lokal/offline.

Event yang dipicu tidak ditandatangani. Selama pengujian, nonaktifkan verifikasi signature webhook di endpoint Anda — misalnya, gunakan unsafe_unwrap() alih-alih unwrap() di webhook handler Anda hanya selama pengujian.

Event webhook yang didukung

Category	Events
Subscription	`active`, `updated`, `on_hold`, `renewed`, `plan_changed`, `cancelled`, `failed`, `expired`
Payment	`succeeded`, `failed`, `processing`, `cancelled`
Refund	`succeeded`, `failed`
Dispute	`opened`, `expired`, `accepted`, `cancelled`, `challenged`, `won`, `lost`
License	`created`

Environment variable

Variable	Description
`DODO_WH_TEST_SERVER_URL`	Menimpa URL server relay webhook default yang digunakan oleh `dodo wh listen`

Pembaruan

CLI memeriksa versi yang lebih baru saat startup dan menampilkan notifikasi di status bar jika versi tersebut tersedia. Untuk memperbarui:

/update

Atau, jalankan kembali installer untuk memperbarui secara langsung:

curl -fsSL https://dodopayments.com/install.sh | sh

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Resource

GitHub Repository

Lihat source code dan rilis

npm Package

Lihat di npm registry

Dukungan

Discord: Bergabunglah dengan server komunitas kami
GitHub: Buka issue di repository
Email: Hubungi kami di support@dodopayments.com

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Fitur

Instalasi

Instal dengan npm atau Bun

Instalasi manual (tidak memerlukan Node / Bun)

Autentikasi

Beralih mode dan logout

Penggunaan

1. TUI interaktif (disarankan)

2. Subperintah langsung

Asisten AI

Pembuatan Struktur Proyek

Referensi Perintah

Produk

Pembayaran

Customer

Diskon

Lisensi

Addon

Refund

Checkout

Webhook

Mendengarkan webhook

Memicu webhook test

Event webhook yang didukung

Environment variable

Pembaruan

Resource

GitHub Repository

npm Package

Dukungan

​Fitur

​Instalasi

​Instal dengan npm atau Bun

​Instalasi manual (tidak memerlukan Node / Bun)

​Autentikasi

​Beralih mode dan logout

​Penggunaan

​1. TUI interaktif (disarankan)

​2. Subperintah langsung

​Asisten AI

​Pembuatan Struktur Proyek

​Referensi Perintah

​Produk

​Pembayaran

​Customer

​Diskon

​Lisensi

​Addon

​Refund

​Checkout

​Webhook

​Mendengarkan webhook

​Memicu webhook test

​Event webhook yang didukung

​Environment variable

​Pembaruan

​Resource

GitHub Repository

npm Package

​Dukungan

Fitur

Instalasi

Instal dengan npm atau Bun

Instalasi manual (tidak memerlukan Node / Bun)

Autentikasi

Beralih mode dan logout

Penggunaan

1. TUI interaktif (disarankan)

2. Subperintah langsung

Asisten AI

Pembuatan Struktur Proyek

Referensi Perintah

Produk

Pembayaran

Customer

Diskon

Lisensi

Addon

Refund

Checkout

Webhook

Mendengarkan webhook

Memicu webhook test

Event webhook yang didukung

Environment variable

Pembaruan

Resource

Dukungan