PAYCOW / DOCUMENTATION

Error handling

Endpoints, error handling and executable examples.

Error Handling

Understand HTTP status codes and error response format

PayCow uses standard HTTP status codes. Error responses return a JSON object with a descriptive msg or error field.

Status Code Meaning
200 / 201Success
400Bad Request — Invalid or missing parameters
401Unauthorized — Missing or invalid API credentials
403Forbidden — Account suspended or subscription exceeded
404Not Found — Payment session does not exist
409Conflict — Idempotency key reused with mismatched parameters
429Too Many Requests — Rate limit exceeded; retry with exponential backoff
500Internal Server Error — Retry with Idempotency-Key