Cada plataforma de pagos necesita una forma para que los desarrolladores prueben sin mover dinero real. 0fee.dev necesitaba algo que va más allá -- un sistema de pruebas que simula no solo pagos con tarjeta sino también USSD push de dinero móvil, validación OTP, flujos de redirección, procesamiento lento y escenarios de fallo. Todo sin tocar un solo proveedor de pago real.
El proveedor de pruebas usa "montos mágicos" -- montos de transacción específicos que desencadenan comportamientos predeterminados: 10000 para éxito instantáneo, 99999 para fallo inmediato, 55555 para pendiente para siempre, 77777 para éxito lento (30s de retraso), 88888 para OTP requerido y 44444 para flujo de redirección. Cualquier otro monto resulta en éxito con 2 segundos de retraso.
Para pruebas de pagos con tarjeta, el proveedor reconoce los números de tarjeta de prueba compatibles con Stripe: 4242424242424242 para éxito, 4000000000000002 para rechazo, etc. Para pruebas de dinero móvil, números de teléfono mágicos controlan el resultado: +11111111111 para éxito instantáneo, +22222222222 para fallo, +44444444444 para OTP requerido (código: 123456).
En la Sesión 033, implementamos fallback automático al proveedor de pruebas cuando un desarrollador usaba una clave sandbox y ningún proveedor real estaba configurado. En la Sesión 043, lo eliminamos como problema de seguridad crítico: si un desarrollador accidentalmente usaba una clave sandbox en código de producción, los pagos se enrutarían silenciosamente al proveedor de pruebas en lugar de fallar ruidosamente, causando pesadillas de conciliación.
El proveedor de pruebas se siembra en la tabla de enrutamiento con prioridad 100 (la más baja), asegurando que nunca tome precedencia accidentalmente sobre proveedores reales. Los desarrolladores pueden probarlo agregándolo explícitamente a la configuración de proveedores de su app.
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.