Stripe tiene stripe-cli. Toda plataforma de pagos que se toma en serio la experiencia del desarrollador ofrece una interfaz de línea de comandos. Para 0fee.dev, construimos zerofee-cli -- una herramienta de terminal basada en Python que permite a los desarrolladores autenticarse, crear pagos, reenviar webhooks a localhost, transmitir logs de eventos y gestionar configuración sin abrir un navegador.
Stack tecnológico
Elegimos cuatro bibliotecas Python: Typer para el framework CLI, Rich para salida de terminal bonita, httpx para HTTP async, y websockets para streaming de eventos en tiempo real.
Estructura del proyecto
Cuatro archivos: config.py (gestión de configuración en ~/.zerofee/), api.py (cliente HTTP con auth y manejo de errores), main.py (todos los comandos) y __init__.py. La simplicidad es intencional.
Comandos
login/logout/status-- autenticación con validación inmediata de clavepayments create/list/get/cancel-- operaciones de pago con tablas Richlisten-- reenvío de webhooks con WebSocket primario y polling como respaldologs tail-- streaming de logs de eventos en tiempo realtrigger-- disparo de eventos webhook de pruebaconfig show/set-- gestión de configuración
Reenvío de webhooks: listen
El comando listen es la funcionalidad más interesante técnicamente. Conecta la máquina local del desarrollador al flujo de eventos de 0fee.dev, reenviando cada evento webhook a una URL local. El enfoque de doble estrategia -- WebSocket primario, polling como respaldo -- asegura que el CLI funcione en todo entorno de red, incluyendo firewalls corporativos y conexiones inestables en África.
Lecciones aprendidas
Typer elimina el código repetitivo. WebSocket con polling como respaldo es el patrón correcto. Las tablas Rich superan a los volcados JSON. Cuatro archivos es suficiente -- sin sistema de plugins, sin cadena de middleware, sin clases abstractas base.
Este artículo es parte de la serie "Cómo construimos 0fee.dev". 0fee.dev es un orquestador de pagos que cubre más de 53 proveedores en más de 200 países, construido por Juste A. GNIMAVO y Claude desde Abiyán sin ingenieros humanos. Sigue la serie para conocer la historia completa de la construcción.