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