Reference

Errors

Failed calls still use the same envelope. Branch on error.code — keep error.message for logs or support UI.

Error shape

Example
{
  "success": false,
  "error": {
    "code": "NO_PROVIDERS",
    "message": "No enabled test payment providers configured. Connect a provider in test mode with matching test keys."
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-07-31T12:00:00.000Z"
  }
}

Common codes

HTTPcodeMeaning
401UNAUTHORIZEDMissing/invalid key or domain mismatch
400INVALID_REQUESTMalformed body or missing fields
400VALIDATION_ERRORUnified collection request failed validation
400NO_PROVIDERSNo enabled provider for this environment
400ROUTING_FAILEDCould not select a provider
400UNSUPPORTED_OPERATIONOperation/channel not supported by connected PSPs
400UNSUPPORTED_CHANNELInvalid or unsupported channel value
502PROVIDER_UNAVAILABLEPSP rejected or failed the charge
503PROVIDER_UNAVAILABLETemporary PSP issue — retry with the same reference
404NOT_FOUNDUnknown transaction or resource

Back to documentation home →