Sesión 3: sitio web de marketing, 5 nuevos SDKs y Docker

10 de diciembre de 2025. Todavía el mismo día que las Sesiones 001 y 002. A estas alturas, 0fee.dev tenía un backend completo, 7 proveedores de pago, un panel SolidJS, un widget de checkout, tareas de fondo Celery y SDKs en TypeScript y Python. La Sesión 003 agregó un sitio web de marketing inspirado en Stripe, 5 nuevos SDKs cubriendo Go, Ruby, PHP, Java y C#, un stack completo de producción Docker con 7 servicios y un servicio de entrega de webhooks. Aproximadamente 7.650 líneas de código.

El sitio web de marketing

El sitio web de marketing necesitaba lograr una cosa: convencer a un desarrollador que visitara 0fee.dev por primera vez de que esta es una plataforma de pagos seria y profesional que vale la pena integrar. El referente de diseño fue el sitio de marketing de Stripe -- limpio, enfocado en desarrolladores, con ejemplos de código interactivos y precios claros.

El sitio fue construido con SolidJS (coincidiendo con el stack del panel) y TailwindCSS, incluyendo una sección hero con contadores de estadísticas animados, ejemplos de código interactivos con pestañas entre TypeScript, Python, Go y cURL, y un selector de países interactivo mostrando métodos de pago disponibles.

Cinco nuevos SDKs

La Sesión 003 agregó SDKs en Go, Ruby, PHP, Java y C#, llevando el total a 7 lenguajes. Cada SDK siguió el mismo diseño de API: un cliente inicializado con una clave API, métodos basados en recursos (payments, apps, checkout) y manejo de errores consistente.

SDK de Go

gopackage main

import "github.com/0feedev/zerofee-go"

func main() {
    client := zerofee.New("sk_live_your_key_here")

    payment, err := client.Payments.Create(&zerofee.PaymentParams{
        Amount:        5000,
        PaymentMethod: "PAYIN_ORANGE_CI",
        Customer: &zerofee.Customer{
            Phone: "+2250709757296",
        },
    })
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Payment ID: %s\n", payment.ID)
    fmt.Printf("Status: %s\n", payment.Status)
}

SDK de Ruby

rubyrequire "zerofee"

ZeroFee.api_key = "sk_live_your_key_here"

payment = ZeroFee::Payment.create(
  amount: 5000,
  payment_method: "PAYIN_ORANGE_CI",
  customer: { phone: "+2250709757296" }
)

puts payment.id        # "txn_abc123..."
puts payment.status    # "pending"

SDK de PHP

php<?php
require_once 'vendor/autoload.php';

\ZeroFee\ZeroFee::setApiKey('sk_live_your_key_here');

$payment = \ZeroFee\Payment::create([
    'amount' => 5000,
    'payment_method' => 'PAYIN_ORANGE_CI',
    'customer' => ['phone' => '+2250709757296'],
]);

echo $payment->id;      // "txn_abc123..."
echo $payment->status;  // "pending"

SDK de Java

javaimport dev.zerofee.ZeroFee;
import dev.zerofee.model.Payment;
import dev.zerofee.model.PaymentParams;
import dev.zerofee.model.Customer;

public class Example {
    public static void main(String[] args) {
        ZeroFee zf = new ZeroFee("sk_live_your_key_here");

        Payment payment = zf.payments().create(
            new PaymentParams.Builder()
                .amount(5000)
                .paymentMethod("PAYIN_ORANGE_CI")
                .customer(new Customer.Builder()
                    .phone("+2250709757296")
                    .build())
                .build()
        );

        System.out.println(payment.getId());
        System.out.println(payment.getStatus());
    }
}

SDK de C#

csharpusing ZeroFee;

var client = new ZeroFeeClient("sk_live_your_key_here");

var payment = await client.Payments.CreateAsync(new PaymentParams
{
    Amount = 5000,
    PaymentMethod = "PAYIN_ORANGE_CI",
    Customer = new Customer
    {
        Phone = "+2250709757296"
    }
});

Console.WriteLine(payment.Id);      // "txn_abc123..."
Console.WriteLine(payment.Status);  // "pending"

Configuración Docker

El stack Docker define 7 servicios que constituyen el despliegue completo de 0fee.dev: api (backend FastAPI), worker (trabajador Celery), scheduler (Celery beat), dragonfly (caché + broker de mensajes), dashboard (panel del comerciante), website (sitio web de marketing) y nginx (proxy reverso). El servicio nginx usa un perfil de producción, lo que significa que solo se inicia cuando se solicita explícitamente.

Servicio de entrega de webhooks

El último componente construido en la Sesión 003 fue el servicio responsable de entregar eventos de pago a los endpoints de los comerciantes, con generación de firma HMAC-SHA256, reintentos con backoff exponencial, registro de entregas, procesamiento asíncrono basado en cola e manejo de timeouts.

La Sesión 003 en números

Tres sesiones completadas el 10 de diciembre de 2025. El primer día de desarrollo produjo una plataforma de orquestación de pagos con un backend, 7 proveedores, un panel, un widget de checkout, tareas de fondo, 7 SDKs en 7 lenguajes, un sitio web de marketing, despliegue Docker y un servicio de entrega de webhooks. La Sesión 004 agregaría la herramienta CLI, páginas de checkout alojadas y documentación completa de la API.

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 Thales Gnimavo y Claude desde Abiyán sin ningún ingeniero humano. Sigue la serie para conocer la historia completa de construcción.