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 use error codes and messages to troubleshoot issues.

Error codes are usually classified into the following categories:

Common error codes

The following table lists all common error codes for online and in-store payment APIs. 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 API (see the following API-specific error codes section).

resultCode

resultStatus

resultMessage

Further Action

ACCESS_DENIED

F

Access denied

Contact Alipay Technical Support.

API_INVALID

F

API is invalid or not active.

Check whether the current API name is used by mistakes when the API is called.

INVALID_CONTRACT

F

The contract is invalid.

Contact Alipay Technical Support or the Alipay Merchant Service business team.

INVALID_SIGNATURE

F

The signature is invalid.

Check whether the signature is correct. The following signature references are useful:

KEY_NOT_FOUND

F

The key is not found.

Upload the private key in Alipay Developer Center.

MERCHANT_NOT_REGISTERED

F

The merchant is not registered. Please register the merchant by using the registration interface.

Contact Alipay Technical Support.

NO_INTERFACE_DEF

F

API is not defined.

Check whether the URL is correct. Please refer to the endpoint in the API documentation.

PARAM_ILLEGAL

F

Illegal parameters exist. For example, a non-numeric input, or an invalid date.

Check and verify whether the request fields (including the header fields and body fields) of the current API are correct and valid.
For details, see the specific API specification, for example, the API pay (Cashier Payment).

PROCESS_FAIL

F

A general business failure occurred. Do not retry.

Human intervention is usually needed. It is recommended that you contact Alipay Technical Support to troubleshoot the issue.

REQUEST_TRAFFIC_EXCEED_LIMIT

U

The request traffic exceeds the limit.

Call the interface again might help to resolve the issue.

RISK_REJECT

F

The request is rejected because of the risk control.

Prompt the user that the risk control rejects.

SYSTEM_ERROR

F

System error

Contact Alipay Technical Support.

UNKNOWN_EXCEPTION

U

An API calling is failed, which is caused by unknown reasons.

Call the interface again might help to resolve the issue.

API-specific error codes

For error codes that are dedicated to a specific API, see the Result/Error codes section in each API specification. For example, the pay (Cashier Payment) API.