HTTP Response and Error Codes
API Errors
Most common API errors are as follows, including message, reason and status code.
Response example:
{
"error": "API request limit is exceeded",
"error_code": "API_LIMIT_EXCEEDED",
"status": "400"
}
| status | error_code | error |
|---|---|---|
| 400 | AUTHENTICATION_FAILED | Authentication Token is not set or expired. |
| 400 | INVOICE_NOT_EXIST | Invoice does not exist. |
| 400 | INVOICE_VERIFIED_ALREADY | It has been verified already. |
| 400 | INVOICE_CANCELED_FAIILED | Invoice does not exist, or it cannot be canceled. |
| 400 | ORDER_NO_PERMISSION | Order does not exist or permission denied. |
| 400 | ORDER_CANCELED_FAIILED | Order does not exist, or it cannot be canceled. |
| 400 | ORDER_REFUND_FAILED | Order does not exist, or it`s status is not refundable. |
| 400 | ORDER_VERIFIED_ALREADY | Payment has been verified with payment already. |
| 400 | ORDER_VERIFIED_PRICE_NOT_MATCH | Payment money does not match the order money, please double check the price. |
| 400 | ORDER_VERIFIED_MERCHANT_NOT_MATCH | Payment money does not the order of current merchant , please double check the order. |
| 400 | ORDER_NOT_VALID | Order id is not valid. |
| 400 | ORDER_PAID_FAILED | Order not exist or is not paid yet. |
| 400 | ORDER_MERCHANTID_EXIST | Order with same merchant_order_id exisits. |
| 400 | ORDER_NOT_NEW | The current order is not new, and payment method cannot be switched. |
| 400 | PAYMENT_NOT_AVAILABLE | The payment method is not working, please retry later. |
| 400 | MERCHANT_CALLBACK_STATUS_WRONG | The current payment status not ready to send callback. |
| 400 | PARAMETERS_MISSING | Missing parameters. |
| 400 | PAY_PRICE_ERROR | Price amount or currency is not set correctly. |
| 400 | CREDENTIALS_NOT_MATCH | The email or password does not match. |
| 400 | USER_NOT_EXIST | The user does not exist or no permission. |
| 400 | USER_FAILED | The user operatioin failed. |
| 400 | INVITATION_FAILED | The invitation code is not filled correctly. |
| 400 | ERROR | Error. |
| 401 | (Unauthorized) | API credentials are not valid |
| 404 | (Not Found) | Page, action not found |
| 421 | (Too Many Requests) | API request limit is exceeded |
| 500 | (InternalServerError) | Server error in KidaPay |