On this Page
HTTP Status Codes
These are standard HTTP responses returned by PayEngine. 2xx indicates success, 4xx signals user error, and 5xx refers to server-side issues.
Status Code | Message | Meaning |
200 | Ok | Request was successful and contains the response content |
202 | Accepted | Request accepted for processing, not yet completed |
203 | Non-Authoritative Info | Request was successful but contains business logic errors |
400 | Bad Request | The request was incorrect (due to HTTP protocol) |
401 | Unauthorized | Not authorized to access endpoint |
403 | Forbidden | Not authorized to access specific resource |
404 | Not Found | Resource not found |
409 | Conflict | Resource already exists |
500 | Internal Server Error | Unexpected server error |
501 | Not Implemented | Method not implemented |
PayEngine Error Code Ranges
These error codes apply to specific functional areas of the PayEngine platform. Not all are tied to HTTP status codes.
Global Errors
Group | Type | Subtype | Code Range |
global | general errors | N/A | 0 – 499 |
global | header parameter | N/A | 500 – 999 |
global | not defined | not defined | 1000 – 1999 |
Query Parameters
Filtering Errors
Group | Range |
global | 2000 – 2099 |
customer | 2100 – 2199 |
addresses | 2200 – 2299 |
personas | 2300 – 2399 |
payment-instruments | 2400 – 2499 |
orders | 2500 – 2599 |
not defined | 2600 – 2999 |
Ordering Errors
Group | Range |
global | 3000 – 3099 |
customer | 3100 – 3199 |
addresses | 3200 – 3299 |
personas | 3300 – 3399 |
payment-instruments | 3400 – 3499 |
orders | 3500 – 3599 |
not defined | 3600 – 3999 |
Entity-Specific Error Ranges
Customers
Type | Code Range |
general | 4000 – 4099 |
uri parameter | 4100 – 4199 |
body parameters | 4200 – 4999 |
not defined | 5000 – 5999 |
Addresses
Type | Code Range |
general | 6000 – 6099 |
uri parameter | 6100 – 6199 |
body parameters | 6200 – 6999 |
not defined | 7000 – 7999 |
Personas
Type | Code Range |
general | 8000 – 8099 |
uri parameter | 8100 – 8199 |
body parameters | 8200 – 8999 |
not defined | 9000 – 9999 |
Payment Instruments
Type | Code Range |
general | 10000 – 10099 |
uri parameter | 10100 – 10199 |
body parameters | 10200 – 10999 |
not defined | 11000 – 11999 |
Orders
Type | Code Range |
general | 12000 – 12099 |
uri parameter | 12100 – 12199 |
body parameters | 12200 – 12999 |
not defined | 13000 – 13999 |
Transactions
Type | Code Range |
general | 14000 – 14099 |
uri parameter | 14100 – 14199 |
body parameters | 14200 – 14999 |
not defined | 15000 – 15999 |
Payment
Type | Code Range |
body parameters | 16000 – 16999 |
Pick Up Card Errors
These codes mean the card has been flagged by the issuer—usually due to fraud, loss, or theft. The customer must contact their bank.
Code | Meaning |
04 | Pick up card (no fraud suspected) |
07 | Pick up card – fraud suspected |
41 | Lost card – pick up (fraud-related) |
43 | Stolen card – pick up (fraud-related) |
TRAN NOT ALLOWED Errors
These codes indicate that the transaction is not permitted either by the card's settings or the terminal's configuration.
Code | Meaning |
57 | Transaction not permitted – Card-level block |
58 | Transaction not permitted – Terminal-level block |