Dodo CLI

Hantera dina Dodo Payments-resurser, kör AI-drivna frågor mot ditt konto, skapa checkout-sessioner och testa webhooks — allt från terminalen. CLI levereras med ett interaktivt TUI, en inbyggd AI-assistent som drivs av MCP samt offline-testning av webhooks.

Funktioner

Interaktivt TUI — starta dodo utan argument för att öppna hela det interaktiva gränssnittet med kommandopalett, historik och liveaviseringar.
Inbyggd AI-assistent — ställ frågor eller utför åtgärder på vanlig engelska med /ai. Ingen extra konfiguration krävs; den körs dodopayments-mcp lokalt.
Säkert som standard — API-nycklar lagras i operativsystemets hemliga lagring (macOS Keychain, Windows Credential Vault, Linux libsecret). Ingen klartextkonfiguration sparas på disken.
Automatiska uppdateringar — CLI kontrollerar om det finns nya versioner vid start och meddelar dig i appen. Kör /update för att uppgradera på plats.
Webhook-verktyg — lyssna efter live-webhooks eller utlös payloads offline för lokal utveckling.

Installation

Installera CLI med en enda rad på macOS eller Linux:

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

Installera med npm eller Bun

Om du redan har Node eller Bun installerar pakethanterarna alltid den senaste versionen:

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Manuell installation (Node / Bun krävs inte)

Om du helst inte vill skicka ett fjärrskript till sh kan du ladda ned binärfilen själv.

Download the binary

Ladda ned binärfilen för din plattform från den senaste GitHub-versionen.

Plattform	Binärfil
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

På Windows kräver flyttning till C:\Windows\System32 administratörsbehörighet.

(Optional) Verify the download

Varje version publicerar en SHA256SUMS.txt. Verifiera nedladdningen med:

shasum -a 256 -c SHA256SUMS.txt

Autentisering

Innan du använder autentiserade kommandon loggar du in med din API-nyckel:

dodo login

Eller från det interaktiva TUI:t:

/login

Inloggningsflödet kommer att:

Öppna webbläsaren på sidan för Dodo Payments API Keys.
Be dig klistra in din API Key.
Be dig välja en miljö — Test Mode eller Live Mode.
Lagra autentiseringsuppgifterna i operativsystemets hemliga lagring (Keychain på macOS, Credential Vault på Windows, libsecret på Linux).

Eftersom autentiseringsuppgifterna lagras i operativsystemets hemliga lagring kan du behöva ange ditt enhetslösenord första gången CLI läser eller skriver autentiseringsuppgifter. Om du uppgraderar från en äldre version kommer en befintlig API-nyckel i klartext automatiskt att flyttas till den hemliga lagringen och den äldre filen att raderas.

Byta läge och logga ut

Du kan ha en autentiserad nyckel för Test Mode och en för Live Mode samtidigt. Rensa autentiseringsuppgifter så här:

dodo logout

/logout

Utloggningsflödet låter dig välja mellan All accounts, Test Mode eller Live Mode separat.

Användning

Du kan använda CLI i två lägen.

1. Interaktivt TUI (rekommenderas)

Kör dodo utan argument för att starta hela det interaktiva gränssnittet:

dodo

Skriv / för att öppna kommandopaletten, eller börja bara skriva — allt som inte är ett snedstreckskommando skickas till AI-assistenten.

Kommando	Beskrivning
`/help`	Visa kommandoöversikten
`/update`	Sök efter och installera en CLI-uppdatering
`/login`	Autentisera med en API-nyckel
`/logout`	Logga ut från en eller alla miljöer
`/clear`	Rensa TUI-skärmen
`/exit`	Avsluta TUI:t (även: skriv `exit` eller tryck två gånger på `Esc`)

2. Direkta underkommandon

Kör kommandon direkt utan att gå in i TUI:t:

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

Exempel:

dodo payments list 1
dodo customers create
dodo wh trigger

Referenstabellerna nedan visar alla kommandon. I TUI:t lägger du till / före dem; i direktläge tar du bort /.

AI-assistent

Ställ frågor eller utför åtgärder på naturligt språk. Assistenten använder dodopayments-mcp som körs lokalt — ingen ytterligare konfiguration eller OAuth-flow krävs, och din AI-trafik lämnar inte din dator förutom kommunikationen med modellleverantören.

Kommando	Beskrivning
`/ai <query>`	Ställ en fråga till AI-assistenten eller ge den en instruktion
(valfri text som inte börjar med snedstreck)	Skickas som standard till AI-assistenten när du är i TUI:t

Exempel:

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

Assistenten respekterar din aktiva miljö (Test / Live), så den arbetar endast med data från den miljö du är inloggad i.

Projektstrukturering

dodo init skapar Dodo Payments-betalningsroutes direkt i ett befintligt projekt. Den genererar route-filer med standardkod, installerar det matchande @dodopayments/*-adapterpaketet och skriver säkert DODO_PAYMENTS_*-miljövariablerna till din .env (endast variabler som inte redan finns läggs till). Kommandot körs utan inloggning.

dodo init <framework>

Struktur	Beskrivning
`dodo init nextjs`	Skapa betalningsroutes för Next.js App Router (checkout, Customer Portal och webhook-hanterare) med `@dodopayments/nextjs`
`dodo init express`	Skapa betalningsroutes för en Express-server med `@dodopayments/express`
`dodo init better-auth`	Skapa en Better-Auth-plugin-konfiguration med `@dodopayments/better-auth`

För Better-Auth-strukturen kan du skicka en kommaseparerad lista över plugins som ska genereras (alla används som standard): checkout, portal, usage, webhooks.

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

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

Strukturverktyget identifierar automatiskt en src/-katalog och anpassar sökvägarna för utdata. Det identifierar även automatiskt din pakethanterare (bun, pnpm, yarn eller npm) för att köra rätt installationskommando.

Kommandoöversikt

Produkter

Hantera din produktkatalog.

Kommando	Beskrivning
`dodo products list <page>`	Lista produkter
`dodo products create`	Öppna dashboarden för att skapa en produkt
`dodo products info <id>`	Visa information om en specifik produkt

Betalningar

Visa betalningstransaktioner.

Kommando	Beskrivning
`dodo payments list <page>`	Lista betalningar
`dodo payments info <id>`	Hämta information om en specifik betalning

Kunder

Hantera din kundbas.

Kommando	Beskrivning
`dodo customers list <page>`	Lista kunder
`dodo customers create`	Skapa en ny kund
`dodo customers update <id>`	Uppdatera en befintlig kund

Rabatter

Hantera kuponger och rabatter.

Kommando	Beskrivning
`dodo discounts list <page>`	Lista rabatter
`dodo discounts create`	Skapa en ny procentbaserad rabatt
`dodo discounts delete <id>`	Ta bort en rabatt med ID

Licenser

Hantera programvarulicenser.

Kommando	Beskrivning
`dodo licences list <page>`	Lista licenser

Tillägg

Hantera produkttillägg.

Kommando	Beskrivning
`dodo addons list <page>`	Lista tillägg
`dodo addons create`	Öppna dashboarden för att skapa ett tillägg
`dodo addons info <id>`	Visa information om ett specifikt tillägg

Återbetalningar

Visa information om återbetalningar.

Kommando	Beskrivning
`dodo refunds list <page>`	Lista återbetalningar
`dodo refunds info <id>`	Visa information om en specifik återbetalning

Checkout

Skapa hostade checkout-sessioner.

Kommando	Beskrivning
`dodo checkout new`	Skapa interaktivt en hostad checkout-session och hämta en betalningslänk

Webhooks

CLI innehåller två kraftfulla verktyg för att testa webhooks under utveckling: en lyssnare som vidarebefordrar live-testwebhooks till din lokala server och en utlösare som skickar simulerade webhook-payloads till valfri endpoint.

Kommando	Beskrivning
`dodo wh listen`	Lyssna efter webhooks i realtid och vidarebefordra dem till din lokala utvecklingsserver
`dodo wh trigger`	Utlös en test-webhook-händelse interaktivt — även när du är utloggad

Lyssna efter webhooks

Vidarebefordra webhooks från Dodo Payments direkt till din lokala utvecklingsserver i realtid.

dodo wh listen

Enter your local endpoint URL

Ange den lokala URL där du vill ta emot webhooks (t.ex. http://localhost:3000/webhook).

Automatic setup

CLI skapar automatiskt en webhook-endpoint på ditt Dodo Payments-konto om det inte redan finns en, och öppnar sedan en WebSocket-anslutning för att ta emot händelser i realtid.

Receive and forward

När en webhook-händelse utlöses (från en testbetalning, ändring av en prenumeration osv.) tar CLI emot den, loggar händelsetypen och vidarebefordrar hela begäran med headers och body till din lokala endpoint. Svaret från din endpoint loggas och skickas tillbaka.

dodo wh listen kräver en API-nyckel för Test Mode. Nycklar för Live Mode stöds inte av lyssnarflödet.

Lyssnaren bevarar de ursprungliga webhook-headers (webhook-id, webhook-signature, webhook-timestamp) när de vidarebefordras till din lokala endpoint, så att du kan testa din logik för signaturverifiering.

Utlös test-webhooks

Skicka simulerade webhook-payloads till valfri endpoint för snabb testning utan att behöva skapa riktiga transaktioner.

dodo wh trigger

Flödet för /wh trigger guidar dig genom följande:

Ange en destination för endpoint-URL
Välj en specifik händelse att utlösa från en interaktiv meny

dodo wh trigger kräver inte inloggning. Det fungerar som en lokal/offline-generator för webhook-payloads.

Utlösta händelser är inte signerade. Inaktivera verifiering av webhook-signaturer på din endpoint under testningen — använd exempelvis unsafe_unwrap() i stället för unwrap() i din webhook-hanterare endast under testning.

Webhook-händelser som stöds

Kategori	Händelser
Prenumeration	`active`, `updated`, `on_hold`, `renewed`, `plan_changed`, `cancelled`, `failed`, `expired`
Betalning	`succeeded`, `failed`, `processing`, `cancelled`
Återbetalning	`succeeded`, `failed`
Bestridande	`opened`, `expired`, `accepted`, `cancelled`, `challenged`, `won`, `lost`
Licens	`created`

Miljövariabler

Variabel	Beskrivning
`DODO_WH_TEST_SERVER_URL`	Åsidosätt standard-URL:en för webhook-relayservern som används av `dodo wh listen`

Uppdateringar

CLI söker efter en nyare version vid start och visar en avisering i statusfältet när en sådan finns tillgänglig. Uppgradera så här:

/update

Eller kör installationsprogrammet igen för att uppgradera på plats:

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

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Resurser

GitHub Repository

Visa källkod och versioner

npm Package

Visa i npm-registret

Support

Discord: Gå med i vår community-server
GitHub: Skapa ett ärende i kodarkivet
E-post: Kontakta oss på support@dodopayments.com

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Funktioner

Installation

Installera med npm eller Bun

Manuell installation (Node / Bun krävs inte)

Autentisering

Byta läge och logga ut

Användning

1. Interaktivt TUI (rekommenderas)

2. Direkta underkommandon

AI-assistent

Projektstrukturering

Kommandoöversikt

Produkter

Betalningar

Kunder

Rabatter

Licenser

Tillägg

Återbetalningar

Checkout

Webhooks

Lyssna efter webhooks

Utlös test-webhooks

Webhook-händelser som stöds

Miljövariabler

Uppdateringar

Resurser

GitHub Repository

npm Package

Support

​Funktioner

​Installation

​Installera med npm eller Bun

​Manuell installation (Node / Bun krävs inte)

​Autentisering

​Byta läge och logga ut

​Användning

​1. Interaktivt TUI (rekommenderas)

​2. Direkta underkommandon

​AI-assistent

​Projektstrukturering

​Kommandoöversikt

​Produkter

​Betalningar

​Kunder

​Rabatter

​Licenser

​Tillägg

​Återbetalningar

​Checkout

​Webhooks

​Lyssna efter webhooks

​Utlös test-webhooks

​Webhook-händelser som stöds

​Miljövariabler

​Uppdateringar

​Resurser

GitHub Repository

npm Package

​Support

Funktioner

Installation

Installera med npm eller Bun

Manuell installation (Node / Bun krävs inte)

Autentisering

Byta läge och logga ut

Användning

1. Interaktivt TUI (rekommenderas)

2. Direkta underkommandon

AI-assistent

Projektstrukturering

Kommandoöversikt

Produkter

Betalningar

Kunder

Rabatter

Licenser

Tillägg

Återbetalningar

Checkout

Webhooks

Lyssna efter webhooks

Utlös test-webhooks

Webhook-händelser som stöds

Miljövariabler

Uppdateringar

Resurser

Support