Error codes
If an error occurs when you call an API, an error response is returned, where the result object indicates the error code and error message. You can then troubleshoot issues based on error codes.
Error codes are usually classified into the following categories:
- Common error codes: are common for all Alipay+ APIs.
- API-specific error codes: are dedicated to a specific API.
If you cannot locate your error code in the common error codes list, make sure to check the API-specific error codes. If the result persists, contact connect_support@service.alipay.com.
Common error codes
The following table lists all common error codes for APS OpenAPIs for Acquirers. If you do not find an error code in the following table, it means that the error code is not common, but dedicated to a specific OpenAPI (see the following API-specific error codes section).
resultCode | resultMessage | resultStatus | Further action |
UNKNOWN_EXCEPTION | An API call failed, which is caused by unknown reasons. | U | Try to recall the API. |
PROCESS_FAIL | A general business failure occurred. Do not retry. | F | Human intervention is usually needed. It is recommended that you contact connect_support@service.alipay.com to troubleshoot the issue. |
PARAM_ILLEGAL | Illegal parameters. For example, non-numeric input, invalid date. | F | Check and verify whether the request fields, including the header fields and body fields, are correct and valid. For details on the fields of each API, see the specific API Structure section. |
METHOD_NOT_SUPPORTED | The server does not implement the requested HTTPS method. | F | Ensure the HTTP method is POST. |
MEDIA_TYPE_NOT_ACCEPTABLE | The server does not implement the media type that is acceptable to the client. | F | Use a media type that is accepted by Alipay+. |
INVALID_API | The called API is invalid or not active. | F | Check whether the name of the API that is called is correct. |
INVALID_CLIENT | The client is invalid. | F | It is recommended that you contact connect_support@service.alipay.com to troubleshoot the issue. |
INVALID_SIGNATURE | The signature is invalid. | F | Check if the public key, the signed message, and the signature algorithm are as expected. |
KEY_NOT_FOUND | The key is not found. | F | It is recommended that you contact connect_support@service.alipay.com to troubleshoot the issue. |
ACCESS_DENIED | Access is denied | F | Check resultMessage of the API that is called for details. |
REQUEST_TRAFFIC_EXCEED_LIMIT | The request traffic exceeds the limit. | U | The party that calls APIs needs to reduce the API calling frequency, or the API service provider needs to increase the traffic limit or threshold. |
API-specific error codes
For error codes that are dedicated to a specific API, see the Result section in each API specification.