Vai al contenuto
neo-pays

Sviluppatori

Primo pagamento in una sola chiamata.

Chiavi di test che attraversano lo stesso codice della produzione, idempotenza integrata, webhook firmati e una specifica OpenAPI pubblica.

Modalità test

Chiavi di test che attraversano lo stesso codice della produzione.

Le chiavi sk_test_ seguono lo stesso percorso di sk_live_ per i vostri incassi mobile money e tramite bonifico, senza movimenti di denaro.

Una chiave API è mostrata una sola volta, alla creazione. Dati illustrativi.

Contratto

Quattro regole, valide in tutti i linguaggi.

  • Idempotenza

    Inviate Idempotency-Key a ogni creazione: 201 la prima volta, 200 quando la chiave restituisce l'operazione esistente, 409 in caso di conflitto. La chiave designa l'operazione voluta, non il tentativo.

  • Versions

    v1 è una superficie di compatibilità congelata; ogni nuova capacità arriva in v2. Ogni percorso porta il proprio prefisso di versione.

  • Errori

    Un errore si legge dal suo codice, stabile e fatto per essere testato; il messaggio è destinato a una persona e può cambiare.

  • Importi

    Gli importi sono stringhe, mai numeri in virgola mobile.

  • Corridors

    GET /v1/corridors: l'instradamento è ispezionabile — ciò che potete usare, ciò che la piattaforma sceglierà, ciò che potete imporre.

  • Chiavi API

    Una chiave è mostrata una sola volta, alla creazione. Potete limitarla a un elenco di indirizzi IP.

Esempi

Creare un incasso.

L'importo è una stringa, la chiave di idempotenza designa l'operazione voluta — non il tentativo. La vostra dashboard genera questi frammenti per ogni endpoint, con l'URL di base del vostro account.

GET https://api.neo-pays.com/v1/corridors
Authorization: Bearer $NEOPAYS_SECRET_KEY
curl https://api.neo-pays.com/v1/payments \
  -H "Authorization: Bearer $NEOPAYS_SECRET_KEY" \
  -H "Idempotency-Key: commande-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "10000",
    "currency": "XOF",
    "platform_id": "<platform_id>",
    "merchant_reference": "commande-1042"
  }'

HTTP/1.1 201 Created

Webhooks

Firmati, con marca temporale, riconsegnati.

Ogni consegna porta X-NeoPays-Signature: una marca temporale e un HMAC-SHA256 del corpo grezzo. Rifiutate oltre 300 s.

  • 20 tipi di eventi, fino a 10 endpoint per account.
  • Un endpoint di test per verificare la vostra implementazione.
  • Un indirizzo IP di uscita fisso, per le vostre liste di indirizzi consentiti; protezione anti-SSRF lato piattaforma.
POST /webhooks/neo-pays
X-NeoPays-Signature: t=1723651200,v1=9f2c…d41a
Content-Type: application/json

v1 == HMAC-SHA256(secret, t + "." + body)
|now − t| ≤ 300 s
Consegna di un webhook e la sua scala di tentativi: 60 s, 5 min, 30 min, 2 h. Dati illustrativi.

Client di riferimento

Più di dieci linguaggi, nessun pacchetto pubblicato.

Un client di riferimento per linguaggio — un centinaio di righe, senza dipendenze, da copiare nel vostro progetto. Uno script di integrazione ospitato apre il pagamento in una finestra modale sulle vostre pagine web.

Dalla vostra dashboard, ogni endpoint mostra il proprio frammento cURL, PHP, Node.js, Python e Go, generato a partire dalla definizione dell'endpoint stesso.

OpenAPI

Una specifica pubblica, verificata rispetto alle route.

GET /v1/openapi.json: 42 operazioni, verificate rispetto alla tabella delle route a ogni build.

GET https://api.neo-pays.com/v1/openapi.json

Primo pagamento in una sola chiamata.

Prima la documentazione: guide, riferimento generato, webhook. Le chiavi di test attraversano lo stesso codice della produzione.

Leggere la documentazione APICreare un account