Stripe es el proveedor predeterminado de pagos con tarjeta para la mayor parte del mundo. El desafío no es si Stripe funciona -- es cómo integrarlo en un orquestador multi-proveedor sin exponer a los desarrolladores a las particularidades específicas de Stripe en cuanto a formato de moneda, gestión de sesiones y verificación de callbacks.
Este artículo cubre el adaptador de Stripe para 0fee.dev: la API de Checkout Sessions, el manejo de monedas sin decimales (zero-decimal), las funciones de conversión de montos, el patrón de callback intermediario para seguridad y las diferencias entre modo sandbox y live.
La distinción de monedas sin decimales causó un bug real en producción en la Sesión 023. Las monedas como XOF, XAF y JPY no tienen subunidades -- cuando alguien paga 5.000 XOF, envías 5000 a Stripe, no 500000. Las funciones de conversión _convert_amount_to_stripe y _convert_amount_from_stripe manejan esto explícitamente, con el patrón int(round(...)) para eliminar problemas de precisión de punto flotante descubiertos en la Sesión 063.
El patrón de callback intermediario resuelve un problema de seguridad fundamental: las redirecciones del lado del cliente no prueban que el pago tuvo éxito. En lugar de enviar la URL de éxito del desarrollador a Stripe, enviamos nuestra propia URL de callback, verificamos el pago contra la API de Stripe y solo entonces redirigimos al cliente a la URL del desarrollador.
Tres lecciones de la integración de Stripe: las monedas sin decimales no son casos extremos para una plataforma que apunta a África; la aritmética de punto flotante nunca es segura para dinero; y nunca confíes en redirecciones del lado del cliente para verificación de pagos.
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.