Authenticatie

Elk request identificeert uw account met een public key:

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

De key kan veilig in een browserbundle worden meegeleverd. Er kunnen betalingen mee worden aangemaakt en een betaling kan ermee worden opgevraagd via de ID, maar de key kan geen geld verplaatsen, uw afwikkelingswallets niet wijzigen en niet bij de gegevens van een andere merchant. Voor accountbrede opvragingen gebruikt u in plaats daarvan uw API-sleutel en secret.

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

API-sleutel en secret

Accountbrede opvragingen, de betalingslijst (/payments/merchant/list) en de betalingsstatistieken (/payments/merchant/stats), authenticeren met uw API-sleutel en secret, te vinden onder Dashboard, Settings, API:

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

• Verstuur ze alleen vanaf uw server. De secret mag nooit een browser bereiken.
• Verstuur deze twee headers zonder X-Public-Key. Als er een public key aanwezig is, wordt het request in plaats daarvan met de public key geauthenticeerd.
• De API-sleutel en secret lezen altijd gegevens uit de 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"

Aanroepen van deze twee routes met alleen een public key werken voorlopig nog, en de response bevat dan een header Deprecation: true. Zet ze om naar de API-sleutel en secret. Integraties die de API-sleutel en secret al bij elk request meesturen, blijven werken.

Ontbrekende of ongeldige inloggegevens

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

Wordt geretourneerd met 401.