Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

      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.