Alipay International Mini Program Development PlatformAlipay International Mini Program Development PlatformDOCS

Error codes

If an error occurs when you call an API, an error response is returned, where the object result indicates the error code (resultCode) and error message (resultMessage). 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 Mini Program OpenAPIs for ISVs. 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.

Error code

Result status

Error message

Further action

PARAM_ILLEGAL

F

Illegal parameters. For example, non-numeric input, 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, syncBenefit.

BIZ_ERROR_NEED_RETRY

U

Business exception. You need to retry.

Try again later.

BIZ_ERROR_NO_RETRY

F

Business exception. You don't need to retry.

We recommend that you contact Technical Support to troubleshoot the issue. 

SYSTEM_ERROR

U

System error

Try again later.

ACCESS_FORBIDDEN

F

Failed to access our server due to either of the following reasons:

  • The channel of synchronization is closed.
  • The contract is expired.
  • Other exceptions

We recommend you contact Technical Support to troubleshoot the issue. 

API-specific error codes

For error codes that are dedicated to a specific API, see the Error codes section in each API specification, for example, syncBenefit.