Back to 0fee
0fee

Billetera y flujo de recarga de fondos

Cómo funciona el sistema de billetera de 0fee.dev: créditos, flujo de recarga, filtrado por país, cupones y gestión de saldo. Por Juste A. Gnimavo y Claude.

Juste A. Gnimavo (Thales) & Claude | March 27, 2026 3 min 0fee
EN/ FR/ ES
walletcreditspayments

Cada comerciante de 0fee.dev tiene una billetera. Es el libro mayor interno que rastrea la acumulación de comisiones de plataforma, créditos, depósitos de recarga y bonificaciones de cupones. La billetera no es una cuenta bancaria -- es una herramienta contable que determina si las comisiones de plataforma de un comerciante están cubiertas.

El sistema de créditos

La billetera opera con un modelo de créditos. Los créditos están denominados en USD y representan comisiones de plataforma prepagadas. Cuando un comerciante procesa una transacción, la comisión del 0,99 % se deduce de su saldo de créditos. La decisión de diseño crítica: el saldo puede ser negativo. Nunca bloqueamos un pago porque el saldo de créditos del comerciante sea insuficiente.

El flujo de recarga de fondos

Los comerciantes recargan fondos a su billetera a través del checkout alojado -- el mismo sistema de checkout que alimenta los pagos de los clientes. Nos comemos nuestra propia comida para perros.

El flujo sigue cuatro pasos: selección de país (determina métodos de pago disponibles), selección de monto (preajustes o valor personalizado con estimación de cobertura de comisiones), aplicación de cupones (descuentos porcentuales o de monto fijo) y checkout alojado (usando nuestra propia API de pagos).

Cuando un cupón da 20 % de descuento, el comerciante paga $8 por $10 en créditos pero recibe los $10 completos. El descuento del cupón es una bonificación real de créditos, no solo una reducción de pago.

Evolución del límite de crédito

El sistema de billetera pasó por una evolución significativa. El diseño original tenía límites escalonados ($-10 para Starter, $-100 para Growth, etc.). Esto creaba incentivos perversos. Cuando pasamos al modelo plano del 0,99 % en la sesión 015, eliminamos todos los límites de crédito. El nuevo enfoque: las comisiones se acumulan sin límite, la factura mensual incluye todas las comisiones acumuladas, y la suspensión solo ocurre el día 10 si no se paga.

Los resultados validaron este enfoque. Los comerciantes que habrían sido bloqueados bajo el sistema escalonado procesaron significativamente más volumen, generando más ingresos por comisiones para 0fee.dev que cualquier nivel de suscripción habría generado.

Por qué este diseño funciona

El sistema de billetera equilibra simplicidad con flexibilidad. Los créditos son fáciles de entender: el dinero entra, las comisiones salen, y el saldo refleja la diferencia. El flujo de recarga usa nuestro propio checkout, demostrando que el producto funciona mientras reduce el esfuerzo de ingeniería. Y el modelo de saldo negativo ilimitado confía en los comerciantes por defecto, lo cual resulta ser la apuesta correcta.


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.

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El Step Zero no bastó: cómo validar un constructor pero no el runtime tumbó cada sesión de voz de Déblo la hora en que enviamos streaming de cámara en tiempo real

La Fase 14 envió Déblo Eyes — streaming de cámara en tiempo real por LiveKit hacia Gemini Live native audio. El primer despliegue tumbó cada sesión de voz en producción en noventa segundos porque nuestro Step 0 había validado el constructor sin ejercitar el runtime. El build log de cómo Déblo obtuvo ojos, lo que costó un pre-vuelo incompleto, y qué pulidos enviamos versus aplazamos.

33 min May 20, 2026
debloclaude-opus-4.7claude-codegemini-live +25
Thales & Claude deblo

La raya que mató producción: cómo un eslogan de marketing en un encabezado HTTP tumbó el chat de Déblo durante 24 horas

Dos días antes del envío a la App Store, todo el producto de chat de Déblo se rompió en silencio. Sin spinner, sin toast, sin error en la UI — solo aire muerto. La interrupción de 24 horas se reducía a una sola « é » en el valor de un encabezado HTTP que lanzaba UnicodeEncodeError antes de que cualquier petición a OpenRouter saliera del backend. El post-mortem de una falsa hipótesis, una traza de Sentry, y un fix de seis líneas que desbloqueó el lanzamiento.

29 min May 19, 2026
debloclaude-opus-4.7claude-codeincident +19
Thales & Claude deblo

Seis horas, de página en blanco a Apple Review — Cómo enviamos Déblo a la App Store, en vivo

Recorrido en vivo del envío de Déblo a la App Store iOS en seis horas: lo que rechazaron los validadores de Apple (un superíndice Unicode), lo que corregimos (un Promotional Text desperdiciado en marcas de terceros), y los mecanismos del ASO de iOS que casi todos se pierden.

30 min May 13, 2026
debloclaude-opus-4.7claude-codeapp-store +16