La incorporación de desarrolladores es la mayor palanca en la adopción de APIs de pago. Si un desarrollador no puede procesar un pago de prueba en diez minutos después de registrarse, se va. En las sesiones 029 y 039, construimos un stepper de incorporación guiado que lleva a los desarrolladores desde la creación de cuenta hasta su primer pago en vivo -- con auto-verificación, seguimiento visual de progreso y un entorno sandbox que no requiere configuración.
Los seis pasos
Cinco pasos requeridos y uno opcional: Crear primera app, Obtener claves API, Hacer pago de prueba, Configurar proveedores, Ir a producción, y Configurar webhooks (opcional).
El paso de Stripe que fue eliminado
La sesión 029 incluía un paso dedicado "Añadir claves de prueba de Stripe". Para la sesión 039, nos dimos cuenta de que esto estaba mal para una plataforma dirigida a desarrolladores de todo el mundo. El proveedor de pruebas integrado ya soporta todos los más de 115 métodos de pago en modo sandbox, haciendo innecesarias las claves sandbox de Stripe.
Internacionalización del snippet de código
El snippet original usaba XOF y PAYIN_ORANGE_CI. En la sesión 039 lo cambiamos a USD y pago genérico con tarjeta, que resuena con una audiencia global de desarrolladores. 0fee.dev es África primero, pero no es solo África.
Polling de auto-verificación
En lugar de pedir a los desarrolladores que hagan clic en "Ya lo hice", consultamos al backend cada cinco segundos para verificar si la condición de completitud de cada paso se ha cumplido. El estado persiste en el servidor basado en el estado real de la plataforma (¿existe una app? ¿hay transacciones sandbox?), no en un registro separado de "progreso de incorporación".
Lecciones aprendidas
- Elimina pasos específicos de proveedor temprano.
- La auto-verificación supera a las casillas de verificación.
- Haz polling responsablemente -- cinco segundos es el punto ideal.
- El estado debe reflejar la realidad.
- Internacional por defecto.
El stepper redujo el tiempo desde el registro hasta el primer pago de prueba a menos de cinco minutos. No es la funcionalidad más compleja técnicamente de 0fee.dev, pero puede ser la más importante comercialmente.
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.