Dodo CLI

Dodo CLI hanterar dina Dodo Payments-resurser, besvarar frågor om ditt konto med en inbyggd AI-assistent, skapar checkout-sessioner och testar webhooks – allt från din terminal. Använd dess interaktiva TUI eller kör direkta underkommandon från skript.

Funktioner

Interaktiv TUI: Kör dodo utan argument för att öppna det interaktiva gränssnittet med kommandopalett, historik och aviseringar i realtid.
Inbyggd AI-assistent: Ställ frågor eller utför åtgärder på vanlig engelska med /ai. Assistenten kör dodopayments-mcp lokalt och kräver ingen extra konfiguration.
Krypterade autentiseringsuppgifter: API-nycklar lagras i ~/.dodopayments/config.json och krypteras med AES-256-GCM samt en nyckel som härleds från din dator. Inga autentiseringsuppgifter i klartext lagras på disken.
Automatiska uppdateringar: CLI:t söker efter nya versioner vid start och meddelar dig i TUI:n. För npm- och Bun-installationer kör du /update för att uppgradera på plats.
Webhook-verktyg: Vidarebefordra webhooks i testläge till din lokala server eller skicka simulerade webhook-payloads offline.
Projektgenerering: Lägg till billing-rutter i Next.js-, Express- och Better Auth-projekt med dodo init.

Installation

På macOS eller Linux installerar du den senaste binärutgåvan med installationsskriptet:

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

Skriptet verifierar binären mot utgåvans SHA-256-kontrollsummor. Det installerar dodo i den första skrivbara katalogen av /usr/local/bin, ~/.local/bin och ~/bin, eller i ~/.local/bin om ingen av dem är skrivbar. Om du vill installera en specifik utgåva anger du dess tagg i miljövariabeln DODO_VERSION. Om du vill välja katalog anger du DODO_INSTALL_DIR.

Installera med NPM eller Bun

Om du har Node.js eller Bun installerar du paketet dodopayments-cli globalt. Installationer via pakethanterare hämtar den senast publicerade versionen:

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Direkta underkommandon som dodo login körs med Node.js 18 eller senare. När du installerar via en pakethanterare behöver den interaktiva TUI:n även Bun. Utgåvans binärer kräver ingen av dessa runtime-miljöer.

Manuell installation (utan Node / Bun)

Om du vill installera utan att köra ett fjärrskript laddar du själv ner binären.

Download the Binary

Ladda ner binären för din plattform från den senaste GitHub-utgåvan.

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

I Windows kräver det administratörsbehörighet att flytta filen till C:\Windows\System32.

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

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

(Optional) Verify the Download

Varje utgåva publicerar en fil med SHA256SUMS.txt. Ladda ner den bredvid binären och verifiera sedan binären:

shasum -a 256 -c SHA256SUMS.txt

Autentisering

Logga in med en API-nyckel innan du kör kommandon som läser från eller ändrar ditt konto. Om du vill logga in med ett direkt underkommando skickar du nyckeln och dess läge, test eller live:

dodo login "$DODO_PAYMENTS_API_KEY" test

Eller från den interaktiva TUI:n:

/login

Inloggningsflödet i TUI:n:

Öppnar kontrollpanelens sida Developer → API Keys i din webbläsare.
Ber dig klistra in din API-nyckel.
Ber dig välja Test Mode eller Live Mode.

Båda kommandona verifierar nyckeln genom en begäran till API:t och lagrar den sedan krypterad i ~/.dodopayments/config.json.

Krypteringsnyckeln härleds från din dator, så de lagrade autentiseringsuppgifterna fungerar endast på den datorn. Om du uppgraderar från v3.0.x, som lagrade nycklar i operativsystemets nyckelring, kör du dodo login igen. Nycklar i den äldre filen med klartext, ~/.dodopayments/api-key, migreras automatiskt och filen tas bort.

Byta läge och logga ut

Du kan vara inloggad med en testlägesnyckel och en live-lägesnyckel samtidigt. Om du vill byta aktivt läge i TUI:n kör du /switch. Ta bort lagrade nycklar så här:

dodo logout all

/logout

I direktläge skickar du test, live eller all. I TUI:n ber /logout dig välja All accounts, Test Mode eller Live Mode och ber dig sedan bekräfta.

Användning

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

1. Interaktiv TUI (rekommenderas)

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

dodo

Skriv / för att öppna kommandopaletten. Text som inte börjar med / skickas till AI-assistenten.

Kommando	Beskrivning
`/help`	Visa kommandoreferensen
`/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
`/switch`	Växla mellan testläge och liveläge
`/clear`	Rensa TUI-skärmen
`/exit`	Avsluta TUI:n (även: skriv `exit` eller tryck två gånger på `Esc`)

2. Direkta underkommandon

Kör ett kommando utan att öppna TUI:n:

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

Exempel:

dodo payments list 1
dodo customers list 1
dodo wh trigger payment.success http://localhost:3000/webhook

Referenstabellerna nedan listar alla kommandon i direktläge. I TUI:n ersätter du dodo med /, till exempel /payments list 1. Kommandon som är märkta endast TUI är interaktiva guider. I direktläge skriver de ut ett meddelande som ber dig öppna TUI:n.

AI-assistent

Ställ frågor om ditt konto eller utför åtgärder på vanlig engelska. Assistenten kör dodopayments-mcp på din dator och kräver därför ingen extra konfiguration eller OAuth-flow. Den anropar Dodo Payments API från din dator med din lagrade nyckel och skickar dina frågor till språkmodellen.

Kommando	Beskrivning
`/ai <query>`	Ställ en fråga till AI-assistenten eller ge den en instruktion
(valfri text utan snedstreck)	Skickas som standard till AI-assistenten i TUI:n

I direktläge kör du dodo ai följt av din fråga. Exempel i TUI:n:

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

Assistenten använder ditt aktiva läge (testläge eller liveläge) och fungerar endast med data från det läget.

Projektgenerering

dodo init lägger till Dodo Payments billing-rutter i ett befintligt projekt. Det skriver ruttfilerna, installerar det matchande adapterpaketet @dodopayments/* och lägger till saknade DODO_PAYMENTS_*-variabler med platshållarvärden i din .env-fil. Filer och variabler som redan finns hoppas över, och kommandot körs utan inloggning.

dodo init <framework>

Generering	Beskrivning
`dodo init nextjs`	Generera billing-rutter för Next.js App Router (checkout, kundportal och webhook-hanterare) med `@dodopayments/nextjs`
`dodo init express`	Generera billing-rutter för en Express-server med `@dodopayments/express`
`dodo init better-auth`	Generera en Better-Auth-plugin-konfiguration med `@dodopayments/better-auth`

För Better-Auth-genereringen kan du skicka en kommaseparerad lista över de pluginer som ska genereras: checkout, portal, usage och webhooks. Utan en lista genereras alla fyra.

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

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

Om ditt projekt har en src/-katalog skriver generatorn filerna i den. Den väljer installationskommando från projektets lock-fil (bun, pnpm eller yarn) och använder npm när ingen lock-fil hittas.

Kommandoreferens

Dessa kommandon kräver en inloggad API-nyckel. Listkommandon tar ett valfritt sidnummer, som är 1 som standard, och visar upp till 100 objekt per sida.

Produkter

Hantera din produktkatalog.

Kommando	Beskrivning
`dodo products list <page>`	Lista produkter
`dodo products create`	Öppna kontrollpanelen 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 dina kunder.

Kommando	Beskrivning
`dodo customers list <page>`	Lista kunder
`dodo customers create`	Skapa en ny kund (endast TUI)
`dodo customers update <id>`	Uppdatera en befintlig kund (endast TUI)
`dodo customers portal <id>`	Skapa en tillfällig Customer Portal-session för en kund

Rabatter

Hantera rabattkoder.

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

Licenser

Visa licensnycklar. Kommandot stavas licences.

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 kontrollpanelen 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 (endast TUI)

Webhooks

CLI:t har två webhook-verktyg för utveckling: en lyssnare som vidarebefordrar webhooks i testläge till din lokala server och en utlösare som skickar simulerade webhook-payloads till valfri endpoint.

Kommando	Beskrivning
`dodo wh listen <url>`	Lyssna på webhooks i realtid och vidarebefordra dem till din lokala utvecklingsserver
`dodo wh trigger <event> <url>`	Skicka en simulerad webhook-händelse, även när du är utloggad

I direktläge krävs argumenten. I TUI:n kör du /wh listen eller /wh trigger utan argument för att öppna en interaktiv guide.

Lyssna efter webhooks

Vidarebefordra webhooks från ditt Dodo Payments-konto till din lokala utvecklingsserver i realtid.

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

dodo wh listen http://localhost:3000/webhook

Enter Your Local Endpoint URL

Skicka den lokala URL som ska ta emot webhooks, till exempel http://localhost:3000/webhook. I TUI-guiden ber CLI:t dig ange den.

Automatic Setup

Om ditt konto saknar en webhook-endpoint för CLI:ts reläserver skapar CLI:t en. Endpointen visas i Developer → Webhooks. CLI:t öppnar sedan en WebSocket-anslutning till reläet för att ta emot händelser i realtid.

Receive and Forward

När en webhook-händelse utlöses, till exempel av en testbetalning eller en prenumerationsändring, vidarebefordrar CLI:t payloaden och headers till din lokala endpoint som en POST-begäran. Det loggar händelsetypen och svaret från din endpoint och skickar svaret tillbaka till reläet.

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

Reläet och CLI:n tolkar JSON-bodyt och serialiserar det igen innan det vidarebefordras. Om den vidarebefordrade bodyn skiljer sig byte för byte från originalet, till exempel i talformatet, misslyckas signaturverifieringen även om headers är intakta.

Utlös testwebhooks

Skicka en simulerad webhook-payload till valfri endpoint utan att skapa riktiga transaktioner.

Utlösta händelser är inte signerade: begäran innehåller ingen header med webhook-id, webhook-signature eller webhook-timestamp. Vid testning tolkar du dem med den overifierade metoden (unsafeUnwrap i TypeScript, unsafe_unwrap i Python och UnsafeUnwrap i Go) i stället för unwrap, och byter tillbaka till unwrap innan du går live.

dodo wh trigger payment.success http://localhost:3000/webhook

I direktläge använder payloaden platshållar-ID:n och kunduppgifter. /wh trigger-guiden i TUI:n leder dig genom följande:

Ange en destinationens endpoint-URL.
Ange valfritt Business ID, Product ID, Metadata (ett JSON-objekt), Customer email och Customer ID för payloaden. Tomma fält använder platshållarvärden.
Välj en event att skicka från en interaktiv meny. Du kan skicka flera händelser i följd. Välj exit när du är klar.

dodo wh trigger kräver inte inloggning. Det fungerar som en lokal, offline webhook-payload-generator.

Webhook-händelser som stöds

dodo wh trigger kan skicka simulerade payloads för 46 av de 48 händelsetyper som Dodo Payments levererar. Det stöder inte subscription.past_due eller subscription.unpaused. Skicka händelsenamnet exakt som det listas:

Kategori	Händelser
Subscription	`subscription.active`, `subscription.updated`, `subscription.on_hold`, `subscription.renewed`, `subscription.plan_changed`, `subscription.cancelled`, `subscription.failed`, `subscription.expired`, `subscription.paused`, `subscription.update_payment_method`
Payment	`payment.success`, `payment.failed`, `payment.processing`, `payment.cancelled`
Refund	`refund.success`, `refund.failed`
Dispute	`dispute.opened`, `dispute.expired`, `dispute.accepted`, `dispute.cancelled`, `dispute.challenged`, `dispute.won`, `dispute.lost`
License Key	`licence.created`
Payout	`payout.created`, `payout.in_progress`, `payout.on_hold`, `payout.failed`, `payout.success`
Credit	`credit.added`, `credit.deducted`, `credit.expired`, `credit.rolled_over`, `credit.rollover_forfeited`, `credit.overage_charged`, `credit.overage_reset`, `credit.manual_adjustment`, `credit.balance_low`
Abandoned Checkout	`abandoned_checkout.detected`, `abandoned_checkout.recovered`
Dunning	`dunning.started`, `dunning.recovered`
Entitlement Grant	`entitlement_grant.created`, `entitlement_grant.delivered`, `entitlement_grant.failed`, `entitlement_grant.revoked`

Tre triggernamn skiljer sig från händelsen type i payloaden de skickar: payment.success skickar payment.succeeded, refund.success skickar refund.succeeded och licence.created skickar license_key.created.

Simulerade payload-strukturer följer motsvarande scheman i API-referensen. Se Webhook-händelser för information om vad varje händelse betyder och när Dodo Payments skickar den i produktion.

payout.created skickas medan utbetalningen fortfarande rapporterar statusen not_initiated, så den simulerade payloaden återspeglar även detta. Se Utbetalningshändelser för hela utbetalningens livscykel.

Miljövariabler

Den här variabeln ändrar hur dodo wh listen ansluter:

Variabel	Beskrivning
`DODO_WH_TEST_SERVER_URL`	Åsidosätt den förvalda webhook-reläservern som används av `dodo wh listen`. Ange ett värdnamn utan schema.

Uppdateringar

CLI:t söker efter en nyare version vid start och visar en avisering i statusfältet när en sådan finns. Om du vill uppgradera en npm- eller Bun-installation från TUI:n kör du:

/update

/update kan inte uppgradera en binär utgåva. För binärinstallationer, inklusive installationer med installationsskriptet, länkar det i stället till den senaste GitHub-utgåvan. Om du vill uppgradera från skalet kör du kommandot som du installerade med igen:

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

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Resurser

GitHub Repository

Källkod och utgåvor.

npm Package

dodopayments-cli-paketet i npm-registret.

Support

Discord: Gå med i community-servern.
GitHub: Öppna ett ärende i kodförrådet.
E-post: Kontakta support@dodopayments.com.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Funktioner

Installation

Installera med NPM eller Bun

Manuell installation (utan Node / Bun)

Autentisering

Byta läge och logga ut

Användning

1. Interaktiv TUI (rekommenderas)

2. Direkta underkommandon

AI-assistent

Projektgenerering

Kommandoreferens

Produkter

Betalningar

Kunder

Rabatter

Licenser

Tillägg

Återbetalningar

Checkout

Webhooks

Lyssna efter webhooks

Utlös testwebhooks

Webhook-händelser som stöds

Miljövariabler

Uppdateringar

Resurser

GitHub Repository

npm Package

Support

​Funktioner

​Installation

​Installera med NPM eller Bun

​Manuell installation (utan Node / Bun)

​Autentisering

​Byta läge och logga ut

​Användning

​1. Interaktiv TUI (rekommenderas)

​2. Direkta underkommandon

​AI-assistent

​Projektgenerering

​Kommandoreferens

​Produkter

​Betalningar

​Kunder

​Rabatter

​Licenser

​Tillägg

​Återbetalningar

​Checkout

​Webhooks

​Lyssna efter webhooks

​Utlös testwebhooks

​Webhook-händelser som stöds

​Miljövariabler

​Uppdateringar

​Resurser

GitHub Repository

npm Package

​Support

Funktioner

Installation

Installera med NPM eller Bun

Manuell installation (utan Node / Bun)

Autentisering

Byta läge och logga ut

Användning

1. Interaktiv TUI (rekommenderas)

2. Direkta underkommandon

AI-assistent

Projektgenerering

Kommandoreferens

Produkter

Betalningar

Kunder

Rabatter

Licenser

Tillägg

Återbetalningar

Checkout

Webhooks

Lyssna efter webhooks

Utlös testwebhooks

Webhook-händelser som stöds

Miljövariabler

Uppdateringar

Resurser

Support