Documentazione neo-pays
L'API di incasso e di pagamento di neo-pays: mobile money, bonifico su IBAN dedicato e pagamento istantaneo BCEAO, dietro un'unica integrazione.
Iniziare
- Avvio rapido — dal conto al primo incasso
- Autenticazione — chiavi, modalità di prova, idempotenza
- Riferimento API — tutte le operazioni, generato dalla specifica
Le guide
| Guida | Che cosa copre |
|---|---|
| Incassi | Creare un pagamento, leggerlo, seguirlo |
| Pagamenti | Inviare fondi, e il saldo che li governa |
| Rimborsi | Restituire tutto o parte di un incasso |
| Stati | Il ciclo di vita di un'operazione |
| Webhook | Firma, riconsegna, deduplicazione |
| Errori | La busta, e ciò che ogni codice le chiede di fare |
Tre cose da sapere prima di scrivere codice
Gli importi sono in unità minori, come stringa. "amount_minor": "500000" su un asset a zero
decimali vale 500 000. Mai un numero in virgola mobile, mai un intero JSON: entrambi perdono
centesimi. Il numero di decimali di ogni asset lo fornisce GET /v1/assets — non lo scriva fisso
nel codice.
Gli asset e le piattaforme sono identificativi, non simboli. Lei invia asset_id e
platform_id, non "XOF" né "orange_money". GET /v1/corridors dice quali il SUO conto può
usare, nell'ordine in cui l'instradamento li sceglierebbe.
Non esiste conversione di valuta. Gli importi non si sommano mai tra asset, e nessuna chiamata ne converte uno in un altro.
Una sola versione
L'API è /v1, ed è l'unica. Lo strato di compatibilità haybtech che occupava quel percorso è stato
eliminato il 12/09/2026 — non era mai stato consegnato nulla sopra — e la superficie neo-pays, fino
ad allora montata su /v2, ne ha preso il posto. Se incontra un riferimento a /v2, è obsoleto.