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
| HTTP | code | Meaning |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid key or domain mismatch |
| 400 | INVALID_REQUEST | Malformed body or missing fields |
| 400 | VALIDATION_ERROR | Unified collection request failed validation |
| 400 | NO_PROVIDERS | No enabled provider for this environment |
| 400 | ROUTING_FAILED | Could not select a provider |
| 400 | UNSUPPORTED_OPERATION | Operation/channel not supported by connected PSPs |
| 400 | UNSUPPORTED_CHANNEL | Invalid or unsupported channel value |
| 502 | PROVIDER_UNAVAILABLE | PSP rejected or failed the charge |
| 503 | PROVIDER_UNAVAILABLE | Temporary PSP issue — retry with the same reference |
| 404 | NOT_FOUND | Unknown transaction or resource |
Back to documentation home →