La mejor API es la que no se interpone en tu camino. En la sesión 045, tomamos la decisión de diseño de API más impactante en la historia de 0fee.dev: redujimos los campos requeridos para crear un pago de muchos a tres.
json{
"amount": 5000,
"source_currency": "XOF",
"payment_reference": "ORDER-42"
}Eso es todo. Tres campos. Monto, moneda, referencia. Todo lo demás es opcional, y el sistema establece valores predeterminados inteligentes.
El problema: demasiados campos requeridos
El endpoint original de creación de pagos requería que los desarrolladores especificaran todo por adelantado: método de pago, proveedor, código de método del proveedor, email del cliente, teléfono, nombre, URLs de éxito/cancelación/webhook. Esto era una barrera para la adopción -- 30 minutos leyendo documentación antes de hacer la primera llamada API.
La solución: valores predeterminados inteligentes y checkout alojado
La idea de la sesión 045 fue: cuando se omite payment_method, auto-crear una sesión de checkout y devolver una URL. El checkout alojado maneja todo lo que el desarrollador no especificó.
La integración del desarrollador se reduce a:
typescriptconst response = await fetch('https://api.0fee.dev/v1/payments', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 5000,
source_currency: 'XOF',
payment_reference: 'ORDER-42',
}),
});
const { checkout_url } = await response.json();
window.location.href = checkout_url;Cinco líneas de código significativo. Esa es la integración completa.
El generador inteligente de referencias de factura
La sesión 045 también introdujo un generador de referencias inteligente. En lugar de requerir que los comerciantes creen referencias únicas, el sistema las genera a partir de lo que proporcione el comerciante: {REF_SANITIZADA}-{AAMMDD}-{APP_SLUG}-{SECUENCIA}.
Impacto
La API de 3 campos transformó las métricas de adopción de 0fee.dev. El tiempo desde la clave API hasta el primer pago exitoso se redujo de unos 30 minutos a unos 5 minutos. El checkout alojado absorbió toda la complejidad: detección de país, selección de método de pago, recolección de datos del cliente, enrutamiento al proveedor y manejo de errores.
Más importante aún, hizo 0fee.dev accesible para desarrolladores que no son expertos en pagos. Un desarrollador frontend que nunca ha integrado una API de pagos puede hacerlo ahora con tres campos y una redirecció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 ingenieros humanos. Sigue la serie para conocer la historia completa de la construcción.