No todos los comerciantes tienen un desarrollador. No todos los pagos necesitan una integración API. Los enlaces de pago resuelven ambos problemas: una URL compartible que cualquier comerciante puede crear desde el panel y enviar a cualquier cliente vía WhatsApp, correo, SMS o redes sociales.
El concepto es simple. La implementación tiene más matices de lo que podrías esperar.
Cómo funcionan los enlaces de pago
Un enlace de pago es una URL como https://pay.0fee.dev/pl_abc123xyz que, al visitarla, presenta al cliente una página de checkout. El comerciante configura el monto, la moneda y los campos requeridos del cliente al crear el enlace. El cliente completa sus datos, selecciona un método de pago y completa el pago.
Recolección de datos del cliente
La página de checkout del enlace de pago recolecta información del cliente según la configuración del comerciante. Tres campos están disponibles: nombre, email y número de teléfono, cada uno configurable como visible y/o requerido.
La corrección de estructura payment_data (sesión 024)
En la sesión 024, descubrimos y arreglamos un error crítico en cómo se almacenaban los datos del cliente. La implementación original dispersaba los campos del cliente en el registro de transacción de formas inconsistentes. La corrección consolidó todo en un campo payment_data estructurado.
Email auto-generado para clientes solo con teléfono
Muchos clientes africanos pagan vía dinero móvil y proporcionan solo un número de teléfono. Pero las facturas y recibos necesitan una dirección de email. Lo resolvemos generando un email determinístico a partir del número de teléfono (hash MD5 + @mail.0fee.dev).
Creación de factura desde enlaces de pago
Cuando se completa una transacción de enlace de pago, se genera automáticamente una factura con los datos del comerciante, cliente y transacción.
Conversión de moneda al momento del pago
Los enlaces de pago almacenan montos en la moneda preferida del comerciante, pero el cliente puede pagar en una moneda diferente según su país y método de pago seleccionado. Las tasas se aplican al momento del pago, no al crear el enlace.
Lo que aprendimos
- Los enlaces de pago son la rampa de acceso sin código. Comerciantes que nunca integrarían una API pueden empezar a aceptar pagos en minutos.
- La estructura de datos del cliente debe ser rígida desde el día uno. La corrección de
payment_datanos costó tiempo que debió evitarse con un esquema estricto desde el principio.
- Los clientes solo con teléfono son la norma en África. La solución de email auto-generado es un arreglo pragmático.
- Conversión de moneda al momento del pago, no al crear el enlace. Las tasas cambian diariamente.
- Los enlaces de uso múltiple son sorprendentemente populares. Los comerciantes los usan para servicios recurrentes, páginas de donación y boletos de eventos.
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 ingenieros humanos. Sigue la serie para conocer la historia completa de la construcción.