neo-pays

Avvio rapido

Dal conto al primo incasso, in cinque passi.

1. Creare il suo conto esercente

Si registri sulla dashboard. Il suo conto parte nello stato pending: può esplorare la dashboard e creare chiavi e webhook, ma le chiamate API rispondono client_inactive finché la sua pratica non è validata.

2. Completare la pratica KYB

In Conformità, indichi il rappresentante legale e i titolari effettivi, poi carichi il registro delle imprese (RCCM). Un documento rifiutato lo è sempre con una motivazione — corregga e ripresenti; lo storico è conservato.

Una volta approvata la pratica, il suo conto passa a active e le sue chiavi si aprono. Non serve altro da parte sua.

3. Creare una chiave API

In Sviluppatori → Chiavi API, crei una chiave test e poi, quando è pronto, una live. Il segreto (sk_test_… o sk_live_…) è mostrato una sola volta, alla creazione — lo metta subito nel suo gestore di segreti.

4. Trovare i suoi identificativi di asset e di piattaforma

Prima della prima chiamata, chieda che cosa il suo conto può usare:

curl https://api.neo-pays.com/v1/corridors \
  -H "Authorization: Bearer sk_test_..."

La risposta dà gli asset_id e platform_id da usare, per paese e per verso. GET /v1/assets dà inoltre il numero di decimali di ogni asset — è quello a dire quanto vale un'unità minore.

5. Creare il suo primo incasso

curl https://api.neo-pays.com/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ordine-1042" \
  -d '{
    "asset_id": 1,
    "amount_minor": "500000",
    "country": "SN",
    "platform_id": 1,
    "client_ref": "ordine-1042",
    "payer": { "name": "Adama Diop", "phone": "+221771234567", "country": "SN" }
  }'

La risposta contiene una payment_url (o un deeplink, o un qrcode_url, a seconda del rail): la presenti al suo cliente.

Gli importi sono stringhe, in unità minori. "500000" su un asset a zero decimali vale 500 000. Sempre una stringa, mai un numero in virgola mobile: l'API rifiuta ciò che non si rilegge esattamente.

6. Ascoltare il webhook

Non affidi mai la conferma al ritorno del browser — il cliente può chiudere la scheda. La verità è l'evento payment.success consegnato al suo endpoint (configurarlo), o in mancanza GET /v1/payments/{id}.

E poi