Dodo CLI

Dodo CLI gestiona tus recursos de Dodo Payments, responde preguntas sobre tu cuenta con un asistente de IA integrado, crea sesiones de checkout y prueba webhooks, todo desde tu terminal. Usa su TUI interactiva o ejecuta subcomandos directos desde scripts.

Características

TUI interactiva: Ejecuta dodo sin argumentos para abrir la interfaz interactiva, con una paleta de comandos, historial y notificaciones en tiempo real.
Asistente de IA integrado: Haz preguntas o realiza acciones en lenguaje natural con /ai. El asistente ejecuta dodopayments-mcp localmente y no requiere configuración adicional.
Credenciales cifradas: Las claves de API se almacenan en ~/.dodopayments/config.json, cifradas con AES-256-GCM y una clave derivada de tu máquina. No se almacenan credenciales en texto plano en el disco.
Actualización automática: CLI comprueba si hay nuevas versiones al iniciarse y te notifica en la TUI. Para instalaciones con npm y Bun, ejecuta /update para actualizar directamente.
Herramientas para webhooks: Reenvía webhooks del modo de prueba a tu servidor local o envía payloads de webhook simulados sin conexión.
Scaffolding: Añade rutas de facturación a proyectos de Next.js, Express y Better Auth con dodo init.

Instalación

En macOS o Linux, instala el binario de la versión más reciente con el script de instalación:

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

El script verifica el binario comparándolo con las sumas de comprobación SHA-256 de la versión. Instala dodo en el primer directorio con permisos de escritura entre /usr/local/bin, ~/.local/bin y ~/bin, o en ~/.local/bin si ninguno permite escritura. Para instalar una versión específica, establece la variable de entorno DODO_VERSION con su tag. Para elegir el directorio, establece DODO_INSTALL_DIR.

Instalar con NPM o Bun

Si tienes Node.js o Bun, instala globalmente el paquete dodopayments-cli. Las instalaciones mediante gestores de paquetes obtienen la versión publicada más reciente:

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Los subcomandos directos, como dodo login, se ejecutan en Node.js 18 o posterior. Cuando instalas mediante un gestor de paquetes, la TUI interactiva también necesita Bun. Los binarios de versión no necesitan ningún runtime.

Instalación manual (no requiere Node ni Bun)

Para instalar sin ejecutar un script remoto, descarga el binario tú mismo.

Download the Binary

Descarga el binario para tu plataforma desde la versión de GitHub más reciente.

Plataforma	Binario
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

En Windows, mover el archivo a C:\Windows\System32 requiere privilegios de administrador.

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

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

(Optional) Verify the Download

Cada versión publica un archivo SHA256SUMS.txt. Descárgalo junto al binario y, después, verifica el binario:

shasum -a 256 -c SHA256SUMS.txt

Autenticación

Inicia sesión con una clave de API antes de ejecutar comandos que lean o modifiquen tu cuenta. Para iniciar sesión con un subcomando directo, pasa la clave y su modo, test o live:

dodo login "$DODO_PAYMENTS_API_KEY" test

O, desde la TUI interactiva:

/login

El flujo de inicio de sesión de la TUI:

Abre en tu navegador la página Developer → API Keys del dashboard.
Te solicita que pegues tu clave de API.
Te pide que elijas Test Mode o Live Mode.

Ambos comandos verifican la clave mediante una solicitud a la API y, después, la almacenan cifrada en ~/.dodopayments/config.json.

La clave de cifrado se deriva de tu máquina, por lo que las credenciales almacenadas solo funcionan en esa máquina. Si actualizas desde v3.0.x, que almacenaba las claves en el llavero del sistema operativo, ejecuta de nuevo dodo login. Las claves del archivo anterior en texto plano ~/.dodopayments/api-key se migran automáticamente y el archivo se elimina.

Cambiar de modo y cerrar sesión

Puedes mantener iniciadas al mismo tiempo una clave del modo de prueba y una clave del modo activo. Para cambiar el modo activo en la TUI, ejecuta /switch. Para eliminar las claves almacenadas:

dodo logout all

/logout

En el modo directo, pasa test, live o all. En la TUI, /logout te pide que elijas All accounts, Test Mode o Live Mode y, después, que confirmes.

Uso

Puedes usar CLI en dos modos.

1. TUI interactiva (recomendado)

Ejecuta dodo sin argumentos para abrir la interfaz interactiva:

dodo

Escribe / para abrir la paleta de comandos. El texto que no empieza por / se envía al asistente de IA.

Comando	Descripción
`/help`	Mostrar la referencia de comandos
`/update`	Buscar e instalar una actualización de CLI
`/login`	Autenticarse con una clave de API
`/logout`	Cerrar sesión en uno o todos los entornos
`/switch`	Cambiar entre el modo de prueba y el modo activo
`/clear`	Limpiar la pantalla de la TUI
`/exit`	Salir de la TUI (también: escribe `exit` o pulsa `Esc` dos veces)

2. Subcomandos directos

Ejecuta un comando sin abrir la TUI:

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

Por ejemplo:

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

Las tablas de referencia siguientes muestran todos los comandos en formato de modo directo. En la TUI, sustituye dodo por /; por ejemplo, /payments list 1. Los comandos marcados como solo TUI son asistentes interactivos. En el modo directo, muestran un mensaje que indica que debes abrir la TUI.

Asistente de IA

Haz preguntas sobre tu cuenta o realiza acciones en lenguaje natural. El asistente ejecuta dodopayments-mcp en tu máquina, por lo que no requiere configuración adicional ni un flujo de OAuth. Llama a la API de Dodo Payments desde tu máquina usando la clave almacenada y envía tus indicaciones al modelo de lenguaje.

Comando	Descripción
`/ai <query>`	Hacer una pregunta al asistente de IA o darle una instrucción
(cualquier texto que no empiece por una barra)	Se envía al asistente de IA de forma predeterminada mientras estás en la TUI

En el modo directo, ejecuta dodo ai seguido de tu pregunta. Ejemplos en la TUI:

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

El asistente usa tu modo activo (modo de prueba o modo activo) y solo funciona con los datos de ese modo.

Scaffolding de proyectos

dodo init añade rutas de facturación de Dodo Payments a un proyecto existente. Escribe los archivos de rutas, instala el paquete adaptador correspondiente @dodopayments/* y añade las variables DODO_PAYMENTS_* que falten a tu archivo .env con valores de marcador de posición. Omite los archivos y las variables que ya existen y se ejecuta sin iniciar sesión.

dodo init <framework>

Scaffolding	Descripción
`dodo init nextjs`	Crear las rutas de facturación de Next.js App Router (checkout, Customer Portal y controladores de webhook) mediante `@dodopayments/nextjs`
`dodo init express`	Crear las rutas de facturación del servidor Express mediante `@dodopayments/express`
`dodo init better-auth`	Crear una configuración del plugin de Better-Auth mediante `@dodopayments/better-auth`

Para el scaffolding de Better-Auth, puedes pasar una lista de plugins separados por comas para generarlos: checkout, portal, usage y webhooks. Si no pasas una lista, genera los cuatro.

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

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

Si tu proyecto tiene un directorio src/, el scaffolder escribe los archivos dentro de él. Elige el comando de instalación a partir del archivo de bloqueo de tu proyecto (bun, pnpm o yarn) y usa npm cuando no encuentra ninguno.

Referencia de comandos

Estos comandos requieren una clave de API con sesión iniciada. Los comandos de listado aceptan un número de página opcional, cuyo valor predeterminado es 1, y muestran hasta 100 elementos por página.

Productos

Gestiona tu catálogo de productos.

Comando	Descripción
`dodo products list <page>`	Listar productos
`dodo products create`	Abrir el dashboard para crear un producto
`dodo products info <id>`	Ver los detalles de un producto específico

Pagos

Ver las transacciones de pago.

Comando	Descripción
`dodo payments list <page>`	Listar pagos
`dodo payments info <id>`	Obtener información sobre un pago específico

Clientes

Gestiona tus clientes.

Comando	Descripción
`dodo customers list <page>`	Listar clientes
`dodo customers create`	Crear un cliente nuevo (solo TUI)
`dodo customers update <id>`	Actualizar un cliente existente (solo TUI)
`dodo customers portal <id>`	Crear una sesión temporal de Customer Portal para un cliente

Descuentos

Gestiona los códigos de descuento.

Comando	Descripción
`dodo discounts list <page>`	Listar descuentos
`dodo discounts create`	Crear un descuento nuevo basado en porcentaje (solo TUI)
`dodo discounts delete <id>`	Eliminar un descuento por ID (solo TUI)

Licencias

Ver las claves de licencia. El comando se escribe licences.

Comando	Descripción
`dodo licences list <page>`	Listar licencias

Addons

Gestiona los complementos de productos.

Comando	Descripción
`dodo addons list <page>`	Listar addons
`dodo addons create`	Abrir el dashboard para crear un addon
`dodo addons info <id>`	Ver los detalles de un addon específico

Reembolsos

Ver la información de los reembolsos.

Comando	Descripción
`dodo refunds list <page>`	Listar reembolsos
`dodo refunds info <id>`	Ver los detalles de un reembolso específico

Checkout

Crear sesiones de checkout alojadas.

Comando	Descripción
`dodo checkout new`	Crear interactivamente una sesión de checkout alojada y obtener un enlace de pago (solo TUI)

Webhooks

CLI tiene dos herramientas de webhook para desarrollo: un listener que reenvía webhooks del modo de prueba a tu servidor local y un trigger que envía payloads de webhook simulados a cualquier endpoint.

Comando	Descripción
`dodo wh listen <url>`	Escuchar webhooks en tiempo real y reenviarlos a tu servidor de desarrollo local
`dodo wh trigger <event> <url>`	Enviar un evento de webhook simulado, incluso sin haber iniciado sesión

En el modo directo, los argumentos son obligatorios. En la TUI, ejecuta /wh listen o /wh trigger sin argumentos para abrir un asistente interactivo.

Escuchar webhooks

Reenvía en tiempo real los webhooks de tu cuenta de Dodo Payments a tu servidor de desarrollo local.

dodo wh listen requiere una clave de API de Test Mode. Las claves de Live Mode no son compatibles con el flujo de escucha.

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

Enter Your Local Endpoint URL

Pasa la URL local que debe recibir los webhooks, por ejemplo http://localhost:3000/webhook. En el asistente de la TUI, CLI te la solicita.

Automatic Setup

Si tu cuenta no tiene un endpoint de webhook para el servidor de retransmisión de CLI, CLI crea uno. El endpoint aparece en Developer → Webhooks. Después, CLI abre una conexión WebSocket con el servidor de retransmisión para recibir eventos en tiempo real.

Receive and Forward

Cuando se activa un evento de webhook, por ejemplo debido a un pago de prueba o a un cambio de suscripción, CLI reenvía el payload y los headers a tu endpoint local como una solicitud POST. Registra el tipo de evento y la respuesta de tu endpoint, y envía la respuesta al servidor de retransmisión.

El listener conserva los headers originales del webhook (webhook-id, webhook-signature, webhook-timestamp) al reenviarlos a tu endpoint local, para que puedas probar la lógica de verificación de firmas.

El relay y la CLI analizan el cuerpo JSON y lo serializan de nuevo antes de reenviarlo. Si el cuerpo reenviado difiere byte por byte del original, por ejemplo, en el formato de los números, la verificación de la firma falla aunque los encabezados permanezcan intactos.

Activar webhooks de prueba

Envía un payload de webhook simulado a cualquier endpoint sin crear transacciones reales.

Los eventos activados no están firmados: la solicitud no incluye los headers webhook-id, webhook-signature ni webhook-timestamp. Durante las pruebas, analízalos con el método no verificado (unsafeUnwrap en TypeScript, unsafe_unwrap en Python, UnsafeUnwrap en Go) en lugar de unwrap, y vuelve a cambiar a unwrap antes de pasar a producción.

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

En el modo directo, el payload usa ID de marcador de posición y datos de clientes de ejemplo. El asistente /wh trigger de la TUI te guía por los siguientes pasos:

Establecer una URL de endpoint de destino.
Introducir opcionalmente un Business ID, Product ID, Metadata (un objeto JSON), Customer email y Customer ID para el payload. Los campos vacíos usan valores de marcador de posición.
Seleccionar un evento para enviar desde un menú interactivo. Puedes enviar varios eventos seguidos. Elige exit para terminar.

dodo wh trigger no requiere iniciar sesión. Funciona como un generador local y sin conexión de payloads de webhook.

Eventos de webhook compatibles

dodo wh trigger puede enviar payloads simulados para 46 de los 48 tipos de eventos que entrega Dodo Payments. No admite subscription.past_due ni subscription.unpaused. Pasa el nombre del evento exactamente como aparece en la lista:

Categoría	Eventos
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`

Tres nombres de trigger difieren del type de evento en el payload que envían: payment.success envía payment.succeeded, refund.success envía refund.succeeded y licence.created envía license_key.created.

Las estructuras de los payloads simulados siguen los esquemas correspondientes de la referencia de la API. Consulta Eventos de webhook para saber qué significa cada evento y cuándo lo emite Dodo Payments en producción.

payout.created se emite mientras el payout aún muestra un estado not_initiated, por lo que el payload simulado también lo refleja. Consulta Eventos de payout para conocer el ciclo de vida completo del payout.

Variables de entorno

Esta variable cambia la forma en que dodo wh listen se conecta:

Variable	Descripción
`DODO_WH_TEST_SERVER_URL`	Anula el servidor de retransmisión de webhook predeterminado que usa `dodo wh listen`. Establece un nombre de host sin un esquema.

Actualizaciones

CLI comprueba si hay una versión más reciente al iniciarse y muestra una notificación en la barra de estado cuando está disponible. Para actualizar una instalación de npm o Bun desde la TUI, ejecuta:

/update

/update no puede actualizar un binario de versión. Para las instalaciones binarias, incluida la del script de instalación, enlaza en su lugar a la versión más reciente de GitHub. Para actualizar desde tu shell, vuelve a ejecutar el comando con el que instalaste:

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

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Recursos

GitHub Repository

Código fuente y versiones.

npm Package

El paquete dodopayments-cli en el registro de npm.

Soporte

Discord: Únete al servidor de la comunidad.
GitHub: Abre un issue en el repositorio.
Correo electrónico: Contacta con support@dodopayments.com.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Características

Instalación

Instalar con NPM o Bun

Instalación manual (no requiere Node ni Bun)

Autenticación

Cambiar de modo y cerrar sesión

Uso

1. TUI interactiva (recomendado)

2. Subcomandos directos

Asistente de IA

Scaffolding de proyectos

Referencia de comandos

Productos

Pagos

Clientes

Descuentos

Licencias

Addons

Reembolsos

Checkout

Webhooks

Escuchar webhooks

Activar webhooks de prueba

Eventos de webhook compatibles

Variables de entorno

Actualizaciones

Recursos

GitHub Repository

npm Package

Soporte

​Características

​Instalación

​Instalar con NPM o Bun

​Instalación manual (no requiere Node ni Bun)

​Autenticación

​Cambiar de modo y cerrar sesión

​Uso

​1. TUI interactiva (recomendado)

​2. Subcomandos directos

​Asistente de IA

​Scaffolding de proyectos

​Referencia de comandos

​Productos

​Pagos

​Clientes

​Descuentos

​Licencias

​Addons

​Reembolsos

​Checkout

​Webhooks

​Escuchar webhooks

​Activar webhooks de prueba

​Eventos de webhook compatibles

​Variables de entorno

​Actualizaciones

​Recursos

GitHub Repository

npm Package

​Soporte

Características

Instalación

Instalar con NPM o Bun

Instalación manual (no requiere Node ni Bun)

Autenticación

Cambiar de modo y cerrar sesión

Uso

1. TUI interactiva (recomendado)

2. Subcomandos directos

Asistente de IA

Scaffolding de proyectos

Referencia de comandos

Productos

Pagos

Clientes

Descuentos

Licencias

Addons

Reembolsos

Checkout

Webhooks

Escuchar webhooks

Activar webhooks de prueba

Eventos de webhook compatibles

Variables de entorno

Actualizaciones

Recursos

Soporte