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.

Thales & Claude | March 30, 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