Back to 0fee
0fee

Sesión 4: herramienta CLI, checkout alojado y documentación de la API

Cómo construimos la zerofee-cli, las páginas de checkout alojadas y 5 archivos de documentación de API en una sesión. Análisis profundo de la Sesión 004. Por Juste A. Gnimavo y Claude.

Juste A. Gnimavo (Thales) & Claude | March 27, 2026 3 min 0fee
EN/ FR/ ES
session-004clicheckoutdocumentationdeveloper-experience

Sesión 004, todavía el 10 de diciembre de 2025. La cuarta sesión del día. A estas alturas, existía una plataforma de orquestación de pagos funcional: backend, panel, widget de checkout, 7 SDKs, sitio web de marketing, stack Docker. Lo que faltaba eran herramientas para desarrolladores -- las utilidades que convierten una API usable en una experiencia de desarrollador deliciosa. La Sesión 004 entregó tres: una herramienta de línea de comandos inspirada en Stripe CLI, una página de checkout alojada con soporte multilingüe y 5 archivos de documentación completos.

La zerofee-cli

Cada plataforma de pagos seria tiene un CLI. Stripe tiene stripe-cli. PayPal tiene sus herramientas de desarrollador. 0fee.dev necesitaba zerofee-cli -- una herramienta de terminal que permite a los desarrolladores probar pagos, reenviar webhooks a localhost, transmitir logs de eventos y gestionar la configuración sin salir de su terminal.

La CLI fue construida con Typer (framework CLI moderno basado en Click), Rich (salida bonita de terminal) y httpx (cliente HTTP async). Soporta comandos como login, payments create, listen (reenvío de webhooks) y logs tail.

La función más poderosa del CLI es el reenvío de webhooks -- enrutar webhooks de proveedores desde el servidor de 0fee.dev a un servidor de desarrollo local, similar a stripe listen.

Página de checkout alojada

No todos los comerciantes quieren embeber un widget JavaScript. Algunos prefieren un flujo de redirección: crear una sesión de checkout vía la API, redirigir al cliente a una página alojada por 0fee.dev y recibir un webhook cuando el pago se complete. La página de checkout alojada maneja este flujo.

La página soporta multilingüe (inglés y francés), modo oscuro/claro, flujo de múltiples pasos (selección de método de pago, entrada de número telefónico, verificación OTP si se requiere, procesamiento y confirmación) y diseño responsive.

La implementación usa plantillas Jinja2 renderizadas del lado del servidor por FastAPI, con una única página HTML autónoma sin dependencias externas más allá de las fuentes. El flujo de múltiples pasos se maneja completamente del lado del cliente.

Documentación de la API

Cinco archivos de documentación cubriendo la superficie completa de la API:

  1. docs/api-reference.md -- Referencia completa de API con cada endpoint, esquemas de solicitud/respuesta, métodos de autenticación, códigos de error, límites de tasa y manejo de idempotencia.
  2. docs/integration-guide.md -- Guía de integración paso a paso cubriendo cuatro caminos: checkout alojado, widget Checkout.js, API directa y flujos de dinero móvil.
  3. docs/webhook-guide.md -- Guía de implementación de webhooks con ejemplos de verificación de firma en cuatro lenguajes.
  4. docs/sdk-reference.md -- Documentación de SDK para los 7 lenguajes.
  5. docs/checkout-widget.md -- Documentación del widget Checkout.js con opciones de configuración, manejadores de eventos, temas y ejemplos de integración específicos por framework.

Las primeras cuatro sesiones: una plataforma completa

Después de cuatro sesiones el 10 de diciembre de 2025, 0fee.dev tenía: backend FastAPI con 42 archivos, 7 proveedores de pago, panel SolidJS, widget de checkout, tareas Celery, 7 SDKs, herramienta CLI, sitio web de marketing, checkout alojado, stack Docker y documentación de API.

Cuatro sesiones. Un día. De cero a una plataforma completa de orquestación de pagos. Las sesiones que siguieron durante los próximos 80 días refinarían, pulirían, depurarían y extenderían esta base -- pero el núcleo se construyó en una sola tarde en Abiyán.


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 ningún ingeniero humano. Sigue la serie para conocer la historia completa de construcción.

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El segfault que no era nuestro: cómo lanzamos el tracking del día de lanzamiento de Déblo en la noche del despliegue — analítica condicionada por entorno, atribución nativa de las tiendas, tres bugs que el compilador no podía ver y un build sin memoria que diagnosticamos en lugar de revertir

El 1 de julio de 2026 — el día del lanzamiento — el riesgo nunca fue el texto. Era que las campañas de pago salieran a ciegas. Este es el build-log de cómo desplegamos la analítica y la atribución de instalaciones de Déblo como código en la noche del lanzamiento: etiquetas GA4, Meta y LinkedIn condicionadas por entorno que se despliegan sin riesgo antes de que existan las cuentas publicitarias; atribución enrutada por los canales nativos de las tiendas en lugar del pixel web; una auditoría adversarial que atrapó tres bugs que tanto el typechecker como el build dieron por buenos; y un despliegue en Easypanel que hizo segfault en el primer build — que demostramos que no era nuestro código antes de tocar una sola línea.

18 min Jul 1, 2026
deblolaunch-dayclaude-opus-4.8claude-code +26
Thales & Claude thales

Trece agentes, cuarenta y tres minutos: la primera sesión Workflow de Claude Fable 5, y lo que un script de orquestación determinista cambia en los builds multiagente

Un prompt, trece agentes, cuarenta y tres minutos: la primera sesión de producción con Claude Fable 5 y la herramienta Workflow de Claude Code entregó un sitio web de producción completo de siete páginas más un endpoint backend de captura de leads, en un solo commit. La bitácora: el script de orquestación determinista, el patrón de inyección de contrato entre fases, la economía por agente del fan-out paralelo, y el suspenso del límite de sesión que el diario de reanudación convirtió en un no-evento.

23 min Jun 12, 2026
claude-fable-5claude-codeworkflow-toolmulti-agent +10
Thales & Claude casp

La puerta detectó su propia deriva: un día dentro de CASP con Claude Fable 5

Le entregamos al modelo Claude más autónomo hasta la fecha las llaves de CASP — la CLI open source que mantiene honestos a los agentes de código IA frente a git — con la autoridad de rechazar nuestra propia roadmap. Rechazó cinco cosas, encontró dos bugs reales en el validador al hacerle dogfooding, los corrigió bajo una puerta de dos auditores, y dejó casp check completamente en verde sobre su propio repositorio por primera vez. CASP 0.3.0 es el resultado.

15 min Jun 10, 2026
caspzerosuiteworkflowai-cto +9