Documentación de neo-pays
La API de cobro y de pago de neo-pays: dinero móvil, transferencia a un IBAN dedicado y pago instantáneo del BCEAO, tras una sola integración.
Empezar
- Puesta en marcha — de la cuenta al primer cobro
- Autenticación — claves, modo de prueba, idempotencia
- Referencia de la API — todas las operaciones, generada desde la especificación
Las guías
| Guía | Lo que cubre |
|---|---|
| Cobros | Crear un pago, leerlo, seguirlo |
| Pagos | Enviar fondos, y el saldo que los gobierna |
| Reembolsos | Devolver todo o parte de un cobro |
| Estados | El ciclo de vida de una operación |
| Webhooks | Firma, reenvío, deduplicación |
| Errores | El sobre, y lo que cada código le pide hacer |
Tres cosas que saber antes de escribir código
Los importes van en unidades menores, como cadena de texto. "amount_minor": "500000" sobre un
activo de cero decimales son 500 000. Nunca un número en coma flotante, nunca un entero JSON: ambos
pierden céntimos. El número de decimales de cada activo lo da GET /v1/assets — no lo codifique
en duro.
Los activos y las plataformas son identificadores, no símbolos. Usted envía asset_id y
platform_id, no "XOF" ni "orange_money". GET /v1/corridors dice cuáles puede usar SU cuenta,
en el orden en que el enrutamiento los elegiría.
No existe conversión de divisa. Los importes nunca se suman entre activos, y ninguna llamada convierte uno en otro.
Una sola versión
La API es /v1, y es la única. La capa de compatibilidad haybtech que ocupaba esa ruta fue
suprimida el 12/09/2026 — nunca se entregó nada sobre ella — y la superficie neo-pays, hasta
entonces montada en /v2, ocupó su lugar. Si encuentra una referencia a /v2, está obsoleta.