PayPal cubre más de 200 países y 25 monedas. Es el segundo proveedor global en la tabla de enrutamiento de 0fee, junto con Stripe como pasarela que maneja pagos fuera del ecosistema de dinero móvil de África. Mientras Stripe maneja pagos con tarjeta, PayPal maneja pagos con billetera -- clientes que prefieren pagar desde su saldo de PayPal, cuenta bancaria vinculada o tarjetas almacenadas a través de la interfaz de PayPal.
La API de Orders v2 de PayPal es un proceso de dos pasos: crear la orden y luego capturar los fondos después de que el cliente aprueba. Esto es fundamentalmente diferente del enfoque de un solo paso de Checkout Sessions de Stripe. PayPal requiere un token de acceso OAuth2 para cada llamada a la API, y acepta montos como cadenas decimales ("50.00") en lugar de centavos enteros.
El flujo de redirección funciona así: 0fee crea una orden de PayPal, el cliente es redirigido a PayPal para aprobar, PayPal redirige a nuestro callback, verificamos y capturamos los fondos, luego redirigimos al cliente a la URL de éxito del desarrollador.
La condición de carrera potencial entre el webhook y la redirección del navegador se maneja verificando tanto el estado APPROVED (necesita captura) como COMPLETED (ya capturado vía webhook).
Notablemente, PayPal no soporta XOF, XAF u otras monedas africanas. Esta es precisamente la razón por la que existe 0fee -- PayPal maneja la audiencia global de billeteras, mientras que Hub2, PawaPay y PaiementPro manejan el dinero móvil africano.
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.