Error Codes

Payracle uses standard HTTP status codes. Error responses include a message field and, for validation errors, an errors object.

HTTP Code	Status	Description
200	OK	Request succeeded.
201	Created	Resource created successfully.
400	Bad Request	Invalid request body or missing required parameters.
401	Unauthorized	Missing or invalid API key.
403	Forbidden	Your account does not have permission to perform this action.
404	Not Found	The requested resource does not exist.
422	Unprocessable Entity	Validation failed — check the errors field in the response body.
429	Too Many Requests	Rate limit exceeded. Slow down your requests.
500	Internal Server Error	An unexpected error occurred on the Payracle side. Contact support if this persists.

{
  "message": "The given data was invalid.",
  "errors": {
    "customer_email": ["The customer email field is required."],
    "amount": ["The amount must be at least 100."]
  }
}

Get Started

SDKs & Libraries

API Reference