Interfaz de línea de comandos para interactuar con la API de Dodo Payments desde tu terminal
Administra tus recursos de Dodo Payments, crea sesiones de pago y prueba webhooks directamente desde la terminal. Diseñado para desarrolladores que prefieren la línea de comandos.
Antes de usar la CLI, autentícate con tu clave API:
dodo login
Esto hará lo siguiente:
Abrir tu navegador en la página de claves API de Dodo Payments
Solicitarte que ingreses tu clave API
Pedirte que selecciones el entorno (Modo de prueba o Modo en vivo)
Almacenar tus credenciales localmente en ~/.dodopayments/api-key
La CLI permite almacenar una clave API por entorno. Si se configuran claves tanto para modo de prueba como en vivo, se te pedirá que elijas qué entorno usar en la sesión actual.
Ejecutar dodo sin argumentos muestra todas las categorías disponibles. Ejecutar dodo <category> sin subcomandos muestra los subcomandos disponibles para esa categoría.
Crear una nueva sesión de pago y obtener la URL de checkout
El comando de checkout admite opciones avanzadas que incluyen recopilación mínima de dirección, URL de retorno, aplicación de 3D Secure, códigos de descuento y metadata.
La CLI incluye dos herramientas potentes para probar webhooks durante el desarrollo: un listener que reenvía webhooks de prueba en vivo a tu servidor local y un trigger que envía cargas útiles simuladas a cualquier endpoint.
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
Indica la URL local donde deseas recibir los webhooks (por ejemplo, http://localhost:3000/webhook).
2
Automatic setup
La 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 dispara un evento de webhook (por un pago de prueba, cambio de suscripción, etc.), la 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 devuelve.
El listener de webhooks solo funciona con una clave API en modo de prueba. Asegúrate de haber iniciado sesión con una clave en modo de prueba antes de usar dodo wh listen.
El listener conserva los encabezados originales del webhook (webhook-id, webhook-signature, webhook-timestamp) al reenviarlos a tu endpoint local, para que puedas probar tu lógica de verificación de firmas.
Envía cargas útiles simuladas a cualquier endpoint para realizar pruebas rápidas sin necesidad de crear transacciones reales.
dodo wh trigger
Esto te guía a través de:
Configurar una URL de endpoint de destino
Opcionalmente configurar Business ID, Product ID y Metadata
Seleccionar un evento específico para activar desde un menú interactivo
Enviar la carga útil simulada y ver la respuesta
Después de cada evento, puedes seleccionar otro evento para activar o salir, lo que facilita probar múltiples controladores de eventos en una sola sesión.
La herramienta trigger envía cargas simuladas sin firmas de webhook. Desactiva la verificación de firmas de webhook durante las pruebas usando unsafe_unwrap() en lugar de unwrap() en tu manejador de webhooks.
