Zum Inhalt springen
neo-pays

Entwickler

Erste Zahlung mit einem Aufruf.

Testschlüssel, die denselben Code wie die Produktion durchlaufen, integrierte Idempotenz, signierte Webhooks und eine öffentliche OpenAPI-Spezifikation.

Testmodus

Testschlüssel, die denselben Code wie die Produktion durchlaufen.

sk_test_-Schlüssel nehmen für Ihre Mobile-Money- und Überweisungseinzüge denselben Weg wie sk_live_, ohne dass Geld bewegt wird.

Ein API-Schlüssel wird nur einmal angezeigt, bei seiner Erstellung. Beispieldaten.

Vertrag

Vier Regeln, gültig in jeder Sprache.

  • Idempotenz

    Senden Sie Idempotency-Key bei jedem Anlegen: 201 beim ersten Mal, 200, wenn der Schlüssel den bestehenden Vorgang zurückgibt, 409 bei Konflikt. Der Schlüssel bezeichnet den gewollten Vorgang, nicht den Versuch.

  • Versions

    v1 ist eine eingefrorene Kompatibilitätsoberfläche; jede neue Fähigkeit kommt in v2. Jeder Pfad trägt sein Versionspräfix.

  • Fehler

    Ein Fehler wird über seinen Code gelesen, der stabil und zum Testen gemacht ist; die Meldung richtet sich an einen Menschen und kann sich ändern.

  • Beträge

    Beträge sind Zeichenketten, nie Gleitkommazahlen.

  • Corridors

    GET /v1/corridors: das Routing ist einsehbar – was Sie nutzen können, was die Plattform wählen wird, was Sie vorgeben können.

  • API-Schlüssel

    Ein Schlüssel wird nur einmal angezeigt, bei seiner Erstellung. Sie können ihn auf eine Liste von IP-Adressen beschränken.

Beispiele

Einen Zahlungseinzug anlegen.

Der Betrag ist eine Zeichenkette, der Idempotenzschlüssel bezeichnet den gewollten Vorgang – nicht den Versuch. Ihr Dashboard generiert diese Snippets für jeden Endpunkt, mit der Basis-URL Ihres Kontos.

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

Signiert, zeitgestempelt, erneut zugestellt.

Jede Zustellung trägt X-NeoPays-Signature: einen Zeitstempel und einen HMAC-SHA256 des Rohtexts. Über 300 s hinaus ablehnen.

  • 20 Ereignistypen, bis zu 10 Endpunkte pro Konto.
  • Ein Test-Endpunkt zur Prüfung Ihrer Implementierung.
  • Eine feste ausgehende IP-Adresse für Ihre Positivlisten; Anti-SSRF-Schutz auf Plattformseite.
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
Zustellung eines Webhooks und seine Versuchsstaffel: 60 s, 5 min, 30 min, 2 h. Beispieldaten.

Referenz-Clients

Über zehn Sprachen, kein veröffentlichtes Paket.

Ein Referenz-Client pro Sprache – rund hundert Zeilen, ohne Abhängigkeit, zum Kopieren in Ihr Projekt. Ein gehostetes Einbettungsskript öffnet die Zahlung in einem modalen Fenster auf Ihren Webseiten.

In Ihrem Dashboard zeigt jeder Endpunkt sein Snippet in cURL, PHP, Node.js, Python und Go, generiert aus der Definition des Endpunkts selbst.

OpenAPI

Eine öffentliche Spezifikation, gegen die Routen geprüft.

GET /v1/openapi.json: 42 Operationen, bei jedem Build gegen die Routentabelle geprüft.

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

Erste Zahlung mit einem Aufruf.

Zuerst die Dokumentation: Leitfäden, generierte Referenz, Webhooks. Testschlüssel durchlaufen denselben Code wie die Produktion.

API-Dokumentation lesenKonto erstellen