Authentifizierung

Jede Anfrage identifiziert Ihr Konto mit einem Public Key:

X-Public-Key: pk_your_public_key
Content-Type: application/json

Der Key kann bedenkenlos in einem Browser-Bundle ausgeliefert werden. Er kann Zahlungen erstellen und eine Zahlung anhand ihrer ID abrufen, aber er kann kein Geld bewegen, Ihre Auszahlungs-Wallets nicht ändern und nicht auf die Daten anderer Händler zugreifen. Kontoweite Abrufe verwenden stattdessen Ihren API-Schlüssel und Ihr Secret.

curl https://hub.stablezact.com/api/v1/networks \
  -H "X-Public-Key: pk_your_public_key"

API-Schlüssel und Secret

Kontoweite Abrufe, also die Zahlungsliste (/payments/merchant/list) und die Zahlungsstatistiken (/payments/merchant/stats), authentifizieren sich mit Ihrem API-Schlüssel und Secret, zu finden unter Dashboard, Settings, API:

X-API-Key: your_api_key
X-API-Secret: your_api_secret
Content-Type: application/json

• Senden Sie sie nur von Ihrem Server. Das Secret darf niemals in einen Browser gelangen.
• Senden Sie diese beiden Header ohne X-Public-Key. Ist ein Public Key vorhanden, wird die Anfrage stattdessen mit dem Public Key authentifiziert.
• Schlüssel und Secret lesen immer Daten aus dem Live-Modus.

curl https://hub.stablezact.com/api/v1/payments/merchant/stats \
  -H "X-API-Key: $STABLEZACT_API_KEY" \
  -H "X-API-Secret: $STABLEZACT_API_SECRET"

Aufrufe dieser beiden Routen nur mit einem Public Key funktionieren vorerst noch, und die Antwort enthält einen Header Deprecation: true. Stellen Sie sie auf API-Schlüssel und Secret um. Integrationen, die Schlüssel und Secret bereits bei jeder Anfrage senden, funktionieren weiterhin.

Fehlende oder ungültige Zugangsdaten

{
  "error": "API credentials required. Use x-public-key header or x-api-key and x-api-secret headers."
}

Wird mit 401 zurückgegeben.