paytrack docs
Errors and status codes
Understand paytrack HTTP status codes, standard error responses, and request IDs.
HTTP status codes
200 OKRequest succeeded.201 CreatedResource was successfully created.400 Bad RequestThe request is invalid or missing required fields.401 UnauthorizedMissing, invalid, expired, or revoked API key.403 ForbiddenAPI key is valid, but does not have permission or subscription access.404 Not FoundRequested resource does not exist.409 ConflictRequest conflicts with an existing resource.422 Validation ErrorRequest body is valid JSON but failed validation rules.429 Too Many RequestsRate limit exceeded.500 Internal Server ErrorUnexpected server error.Standard error format
Example
{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or has been revoked.",
"details": {}
},
"request_id": "req_xxx"
}Common examples
Example
{
"success": false,
"error": {
"code": "missing_scope",
"message": "This API key does not have payments:write access.",
"details": { "required_scope": "payments:write" }
},
"request_id": "req_scope_123"
}Example
{
"success": false,
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the reset time.",
"details": { "retry_after": 30 }
},
"request_id": "req_rate_123"
}