Antes de la Sesión 010, crear un pago en 0fee.dev requería múltiples campos: payment_method, country, currency y a veces payment_method_detail. Después de la Sesión 010, requería un solo campo: payment_method: "PAYIN_ORANGE_CI". Una cadena codifica el tipo de operación, el operador y el país. La moneda se deriva automáticamente. El proveedor se selecciona por el motor de enrutamiento. Este único cambio de diseño transformó la API de 0fee.dev de funcional a elegante.
El formato es: PAYIN_{OPERADOR}_{CÓDIGO_PAÍS}. El componente PAYIN es un prefijo fijo, el operador usa su nombre de marca común en mayúsculas (ORANGE, MTN, WAVE, MOOV, MPESA, CARD, PAYPAL), y el código de país es ISO 3166-1 alfa-2 o GLOBAL para métodos no específicos de país.
La detección automática de país y moneda funciona porque el código de país integrado en el método de pago impulsa la resolución automática de moneda: CI -> XOF, KE -> KES, GH -> GHS, etc. Esto reduce una solicitud de seis campos a tres campos: monto, método de pago y cliente.
La tabla de enrutamiento completa mapea cada código unificado a los códigos internos de cada proveedor: PAYIN_ORANGE_CI -> PaiementPro usa "OMCIV2", PawaPay usa "ORANGE_CIV", Hub2 usa "Orange" con parámetro de país.
Al momento de la implementación del formato unificado en la Sesión 010, la tabla de enrutamiento contenía 117 métodos de pago en más de 30 países. El formato fue diseñado para escalar: agregar un nuevo método de pago requiere insertar una fila en la tabla payin_methods y configurar el enrutamiento del proveedor -- sin cambios de código, sin cambio de versión de API, sin actualización de SDK.
El principio de diseño: codificar decisiones en datos, no en parámetros. Cuando un comerciante escribe PAYIN_ORANGE_CI, ha tomado cada decisión: la operación, el operador y la geografía. El sistema deriva todo lo demás.
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.