La interfaz de línea de comandos oficial para Dodo Payments: gestiona recursos, ejecuta consultas potenciadas por IA, crea sesiones de pago y prueba webhooks desde tu terminal.
Administra tus recursos de Dodo Payments, ejecuta consultas potenciadas por IA en tu cuenta, crea sesiones de pago y prueba webhooks, todo desde la terminal. El CLI viene con un TUI interactivo, un asistente de IA incorporado impulsado por MCP y pruebas de webhooks sin conexión.
TUI interactivo: lanza dodo sin argumentos para abrir la interfaz interactiva completa con paleta de comandos, historial y notificaciones en vivo.
Asistente de IA incorporado: haz preguntas o realiza acciones en inglés simple con /ai. Sin configuración adicional, se ejecuta dodopayments-mcp localmente.
Seguro por defecto: las claves API se almacenan en el almacén secreto de tu sistema operativo (macOS Keychain, Windows Credential Vault, Linux libsecret). Sin configuración en texto plano en el disco.
Actualización automática: el CLI verifica la existencia de nuevas versiones al inicio y te notifica en la aplicación. Ejecuta /update para actualizar en el lugar.
Herramientas para webhooks: escucha webhooks en vivo o dispara cargas útiles sin conexión para desarrollo local.
Antes de utilizar comandos autenticados, inicia sesión con tu clave API:
dodo login
O, desde el TUI interactivo:
/login
El flujo de inicio de sesión:
Abre tu navegador en la página de Claves API de Dodo Payments.
Te pide que pegues tu Clave API.
Te solicita elegir un entorno, Modo de prueba o Modo en vivo.
Almacena las credenciales en el almacén de secretos de tu sistema operativo (Keychain en macOS, Credential Vault en Windows, libsecret en Linux).
Dado que las credenciales se almacenan en el almacén de secretos del sistema operativo, es posible que se te solicite tu contraseña del dispositivo la primera vez que el CLI lee o escribe credenciales. Si estás actualizando desde una versión anterior, cualquier clave API en texto plano existente será migrada al almacén secreto y el archivo heredado eliminado automáticamente.
Haz preguntas o toma acciones en lenguaje natural. El asistente usa dodopayments-mcp ejecutándose localmente: no se requiere configuración adicional ni flujo de OAuth, y tu tráfico de IA no sale de tu máquina excepto para comunicarte con el proveedor del modelo.
Comando
Descripción
/ai <query>
Haz una pregunta o da una instrucción al asistente de IA
(cualquier texto sin barra)
Se envía al asistente de IA por defecto mientras estás en el TUI
Ejemplos:
how much revenue did I make this week?/ai create a new customer named Acme Inc./ai find my last failed payment
El asistente respeta tu entorno activo (Prueba / En vivo), por lo que solo opera sobre los datos del entorno en el que estás actualmente autenticado.
El CLI incluye dos herramientas poderosas para probar webhooks durante el desarrollo: un escuchador que reenvía webhooks de prueba en vivo a tu servidor local, y un generador que envía cargas útiles de webhook simuladas a cualquier endpoint.
Comando
Descripción
dodo wh listen
Escucha webhooks en tiempo real y reenvíalos a tu servidor de desarrollo local
dodo wh trigger
Genera un evento de prueba de webhook interactivamente, incluso estando desconectado
Reenvía webhooks de Dodo Payments directamente a tu servidor de desarrollo local en tiempo real.
dodo wh listen
1
Enter your local endpoint URL
Proporciona la URL local donde deseas recibir webhooks (por ejemplo, http://localhost:3000/webhook).
2
Automatic setup
El CLI crea automáticamente un endpoint de webhook en tu cuenta de Dodo Payments si aún no existe, luego abre una conexión WebSocket para recibir eventos en tiempo real.
3
Receive and forward
Cuando se activa un evento de webhook (a partir de un pago de prueba, cambio de suscripción, etc.), el CLI lo recibe, registra el tipo de evento y reenvía la solicitud completa con encabezados y cuerpo a tu endpoint local. La respuesta de tu endpoint se registra y se envía de vuelta.
dodo wh listen requiere una clave API de Modo de prueba. Las claves de Modo en vivo no son compatibles con el flujo de escucha.
El escuchador conserva los encabezados originales del webhook (webhook-id, webhook-signature, webhook-timestamp) al reenviar a tu endpoint local, para que puedas probar tu lógica de verificación de firmas.
Envía cargas útiles de webhook simuladas a cualquier endpoint para pruebas rápidas sin necesidad de crear transacciones reales.
dodo wh trigger
El flujo /wh trigger te guía a través de:
Configurar una URL de endpoint de destino
Seleccionar un evento específico para generar desde un menú interactivo
dodo wh triggerno requiere inicio de sesión. Funciona como un generador de cargas útiles de webhook local/sin conexión.
Los eventos generados no están firmados. Mientras pruebas, desactiva la verificación de firmas de webhooks en tu endpoint; por ejemplo, usa unsafe_unwrap() en lugar de unwrap() en tu manejador de webhooks solo durante las pruebas.
El CLI verifica si hay una versión más reciente al iniciar y muestra una notificación en la barra de estado cuando hay una disponible. Para actualizar:
/update
O, vuelve a ejecutar el instalador para actualizar en el lugar:
curl -fsSL https://dodopayments.com/install.sh | sh
