Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Kelola sumber daya Dodo Payments Anda, jalankan kueri berbasis AI terhadap akun Anda, buat sesi checkout, dan uji webhooks — semua dari terminal. CLI dikirimkan dengan TUI interaktif, asisten AI bawaan yang didukung oleh MCP, dan pengujian webhook offline. 
<iframe
    className="w-full aspect-video rounded-md"
    src="https://www.youtube.com/embed/gwtvQsANbW4"
    title="Dodo CLI | Dodo Payments"
    frameBorder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
    allowFullScreen
></iframe>

​
Fitur

  • Interactive TUI — Luncurkan dodo tanpa argumen untuk membuka antarmuka interaktif lengkap dengan palet perintah, riwayat, dan notifikasi langsung.
  • AI assistant built in — Ajukan pertanyaan atau ambil tindakan dalam bahasa Inggris dengan /ai. Tanpa pengaturan tambahan, menjalankan dodopayments-mcp secara lokal.
  • Secure by default — Kunci API disimpan di penyimpanan rahasia OS Anda (macOS Keychain, Windows Credential Vault, Linux libsecret). Tidak ada konfigurasi plaintext di disk.
  • Auto update — CLI memeriksa versi baru saat startup dan memberi tahu Anda di aplikasi. Jalankan /update untuk meningkatkan di tempat.
  • Webhook tooling — Dengarkan webhooks langsung atau picu payload 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, penginstalan melalui package-manager selalu menarik versi terbaru: 

```bash npm
npm install -g dodopayments-cli
Bun
bun install -g dodopayments-cli


### Instalasi manual (tanpa Node / Bun diperlukan)

Jika Anda lebih memilih untuk tidak mengarahkan skrip jarak jauh ke `sh`, unduh binari sendiri.

```lock

Download binari untuk platform Anda dari [GitHub Release](https://github.com/dodopayments/dodopayments-cli/releases) terbaru.

| Platform | Binari |
|----------|--------|
| 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` |


  ```bash Linux / macOS
  mv ./dodo-cli-* ./dodo && chmod +x ./dodo
Windows
ren .\dodo-cli-windows-x64.exe .\dodo.exe


```lock

  ```bash Linux / macOS
  sudo mv ./dodo /usr/local/bin/
Windows
move .\dodo.exe C:\Windows\System32\dodo.exe


```lock

On Windows, moving to `C:\Windows\System32` requires administrator privileges.


Each release publishes a `SHA256SUMS.txt`. Verify your download with:

  ```bash
  shasum -a 256 -c SHA256SUMS.txt


## Otentikasi

Sebelum menggunakan perintah yang diotentikasi, masuk dengan kunci API Anda:

```bash
dodo login
Atau, dari dalam TUI interaktif: 
/login
Alur masuk akan:
  1. Membuka browser Anda ke halaman Kunci API Dodo Payments.
  2. Meminta Anda untuk menempelkan Kunci API Anda.
  3. Meminta Anda memilih lingkungan — Test Mode atau Live Mode.
  4. 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 untuk memasukkan **kata sandi perangkat** Anda saat pertama kali CLI membaca atau menulis kredensial. Jika Anda memperbarui dari versi yang lebih lama, kunci API plaintext yang ada akan **dikonversi ke penyimpanan rahasia dan file lama dihapus** secara otomatis.

​
Beralih mode dan keluar

Anda dapat menyimpan satu kunci Test Mode dan satu kunci Live Mode diotentikasi sekaligus. Untuk menghapus kredensial: 

```bash Direct
dodo logout
TUI
/logout


Alur keluar memungkinkan Anda memilih antara **Semua akun**, **Test Mode**, atau **Live Mode** secara independen.

## Penggunaan

Anda dapat menggunakan CLI dalam dua mode.

### 1. TUI Interaktif (disarankan)

Jalankan `dodo` tanpa argumen untuk meluncurkan antarmuka interaktif penuh:

```bash
dodo
Ketik / untuk membuka palet perintah, atau cukup mulai mengetik — apa pun yang bukan perintah garis miring dikirim ke asisten AI.
PerintahDeskripsi
/helpTampilkan referensi perintah
/updatePeriksa dan instal pembaruan CLI
/loginOtentikasi dengan kunci API
/logoutKeluar dari satu atau semua lingkungan
/clearBersihkan layar TUI
/exitKeluar dari TUI (juga: ketik exit, atau tekan Esc dua kali)

​
2. Subperintah langsung

Jalankan perintah langsung tanpa memasuki TUI: 
dodo <category> <sub-command> [args...]
Contoh: 
dodo payments list 1
dodo customers create
dodo wh trigger
Tabel referensi di bawah ini menunjukkan setiap perintah. Dalam TUI, awali dengan /; dalam mode langsung, hapus /.

​
Asisten AI

Ajukan pertanyaan atau ambil tindakan dalam bahasa alami. Asisten ini menggunakan dodopayments-mcp yang berjalan secara lokal — tidak memerlukan penyiapan tambahan atau alur OAuth, dan lalu lintas AI Anda tidak meninggalkan mesin Anda kecuali untuk berbicara dengan penyedia model.
PerintahDeskripsi
/ai <query>Ajukan pertanyaan kepada asisten AI atau berikan instruksi
(teks non-garis miring apa pun)Dikirim ke asisten AI secara default 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 menghormati lingkungan aktif Anda (Tes / Langsung), sehingga hanya beroperasi pada data dari lingkungan yang saat ini Anda masuki.

​
Referensi Perintah

​
Produk

Kelola katalog produk Anda.
PerintahDeskripsi
dodo products list <page>Daftar produk
dodo products createBuka dasbor untuk membuat produk
dodo products info <id>Lihat detail untuk produk tertentu

​
Pembayaran

Lihat transaksi pembayaran.
PerintahDeskripsi
dodo payments list <page>Daftar pembayaran
dodo payments info <id>Dapatkan informasi tentang pembayaran tertentu

​
Pelanggan

Kelola basis pelanggan Anda.
PerintahDeskripsi
dodo customers list <page>Daftar pelanggan
dodo customers createBuat pelanggan baru
dodo customers update <id>Perbarui pelanggan yang ada

​
Diskon

Kelola kupon dan diskon.
PerintahDeskripsi
dodo discounts list <page>Daftar diskon
dodo discounts createBuat diskon berbasis persentase baru
dodo discounts delete <id>Hapus diskon berdasarkan ID

​
Lisensi

Kelola lisensi perangkat lunak.
PerintahDeskripsi
dodo licences list <page>Daftar lisensi

​
Addons

Kelola produk tambahan.
PerintahDeskripsi
dodo addons list <page>Daftar addons
dodo addons createBuka dasbor untuk membuat addon
dodo addons info <id>Lihat detail untuk addon tertentu

​
Refunds

Lihat informasi pengembalian dana.
PerintahDeskripsi
dodo refunds list <page>Daftar pengembalian dana
dodo refunds info <id>Lihat detail untuk pengembalian dana tertentu

​
Checkout

Buat sesi checkout yang dihosting.
PerintahDeskripsi
dodo checkout newBuat sesi checkout yang dihosting secara interaktif dan dapatkan tautan pembayaran

​
Webhooks

CLI menyertakan dua alat kuat untuk menguji webhooks selama pengembangan: listener yang meneruskan webhooks uji langsung ke server lokal Anda, dan trigger yang mengirim payload webhook mock ke endpoint mana pun.
PerintahDeskripsi
dodo wh listenDengarkan webhooks secara real time dan teruskan ke server dev lokal Anda
dodo wh triggerJalankan acara webhook uji secara interaktif — bahkan saat logout

​
Dengarkan webhooks

Teruskan webhooks dari Dodo Payments langsung ke server pengembangan lokal Anda secara real time. 
dodo wh listen

Berikan URL lokal di mana Anda ingin menerima webhooks (misalnya, `http://localhost:3000/webhook`).

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

Ketika acara webhook terjadi (dari pembayaran tes, perubahan langganan, dll.), CLI menerimanya, mencatat jenis acara, dan meneruskan permintaan lengkap dengan header dan badan ke endpoint lokal Anda. Respons dari endpoint Anda dicatat dan dikirim kembali.


```lock
`dodo wh listen` memerlukan kunci API **Test Mode**. Kunci Live Mode tidak didukung oleh alur dengar.

Listener mempertahankan header webhook asli (`webhook-id`, `webhook-signature`, `webhook-timestamp`) saat meneruskan ke endpoint lokal Anda, agar Anda dapat menguji logika verifikasi tanda tangan Anda.

​
Jalankan ujian webhooks

Kirim payload webhook mock ke endpoint apa pun untuk pengujian cepat tanpa perlu membuat transaksi nyata. 
dodo wh trigger
Alur /wh trigger membimbing Anda melalui:
  1. Menetapkan endpoint URL tujuan
  2. Memilih acara spesifik yang akan dijalankan dari menu interaktif
`dodo wh trigger` **tidak** memerlukan login. Ini berfungsi sebagai pembuat payload webhook lokal/offline.

Acara yang dipicu **tidak ditandatangani**. Saat pengujian, nonaktifkan verifikasi tanda tangan webhook di endpoint Anda — misalnya, gunakan `unsafe_unwrap()` daripada `unwrap()` di handler webhook Anda **selama pengujian saja**.

​
Acara webhook yang didukung

KategoriAcara
Subscriptionactive, updated, on_hold, renewed, plan_changed, cancelled, failed, expired
Paymentsucceeded, failed, processing, cancelled
Refundsucceeded, failed
Disputeopened, expired, accepted, cancelled, challenged, won, lost
Licensecreated

​
Variabel lingkungan

VariabelDeskripsi
DODO_WH_TEST_SERVER_URLGanti URL server relay webhook default yang digunakan oleh dodo wh listen

​
Pembaruan

CLI memeriksa versi yang lebih baru saat startup dan menampilkan pemberitahuan di bilah status saat tersedia. Untuk meningkatkan: 
/update
Atau, jalankan kembali penginstal untuk meningkatkan di tempat: 

```bash install.sh
curl -fsSL https://dodopayments.com/install.sh | sh
npm
npm install -g dodopayments-cli
Bun
bun install -g dodopayments-cli


## Sumber Daya

```lock

Lihat kode sumber dan rilis


Lihat di registri npm


## Dukungan

- **Discord**: Bergabunglah dengan [server komunitas](https://discord.gg/bYqAp4ayYh) kami
- **GitHub**: Buka masalah di [repository](https://github.com/dodopayments/dodopayments-cli/issues)
- **Email**: Hubungi kami di support@dodopayments.com
Last modified on May 22, 2026