Fouten

Fouten retourneren een JSON-body met een veld error, en vaak een message met meer details:

{
  "error": "You haven't set up a wallet address for the Polygon network",
  "message": "Please configure a Polygon-specific wallet in your merchant settings before accepting payments on this network.",
  "network": "polygon"
}

Statuscodes

Code	Betekenis
400	het request is geweigerd, lees error
401	ontbrekende of ongeldige inloggegevens
404	dit endpoint bestaat niet, of de resource bestaat niet bij de endpoints die dit gebruiken
500	er is server-side iets misgegaan

Een onbekende betalings-ID retourneert 500

Het opvragen van een betaling die niet bestaat, retourneert 500, niet 404:

{ "success": false, "error": "Failed to query payment status" }

Dit geldt voor de leesendpoints voor betalingen en deposits. Andere endpoints retourneren wel 404 voor een resource die niet bestaat, dus het gedrag is niet consistent binnen de API. Het is gedocumenteerd omdat het vandaag zo werkt: beschouw 500 op deze routes niet per se als een storing. Controleer eerst de ID.

Omdat een wijziging van 500 naar 404 de statuscode voor een bestaande uitkomst zou veranderen, geldt die als breaking volgens ons versiebeleid en wordt die niet ongemerkt in v1 doorgevoerd.

Opnieuw proberen

500-responses op leesendpoints kunnen veilig opnieuw worden geprobeerd.

Een schrijfactie opnieuw proberen is alleen veilig als de server de herhaling kan herkennen. Stuur een Idempotency-Key-header, of ten minste dezelfde orderId. Zie Veilig opnieuw proberen.