Error code
Description
SYSTEM_ERROR
Alipay system is currently not available.
Action: Call the alipay.acquire.overseas.query API to query the status of this payment. For more details, see Case 2.
ILLEGAL_SIGN
Illegal signature
Action: Use a correct signature and try again.
INVALID_PARAMETER
Parameter error
Action: Check the standard of each request parameter according to the API specification. You can log in toiSandboxand use iDiagnose to pinpoint the error.
ILLEGAL_ARGUMENT
Parameter error
Action:Check each request parameter according to the API specification. Contact Alipay technical support if this error persists.
ILLEGAL_PARTNER
Incorrect partner ID
Action:Ensure that the value of partner parameter matches the partner value provided by Alipay. Contact Alipay technical support if this error persists.
ILLEGAL_EXTERFACE
Interface configure error
Action:Ensure that the service parameters have same values with the one in API specification. Contact Alipay technical support if this error persists.
ILLEGAL_PARTNER_EXTERFACE
The partner ID does not have access privilege
Action:Ensure that your agreement with Alipay has been finalized. Contact Alipay technical support if needed.
ILLEGAL_SIGN_TYPE
Illegal sign type
Action:Ensure that the value of sign_type is among MD5, RSA and RSA2. Contact Alipay technical support if this error persists.
HAS_NO_PRIVILEGE
Has no privilege
Action:Contact Alipay technical support for more information.
TRADE_BUYER_NOT_MATCH
The buyer doesn't match.
Action:The merchant can ask the user to show or scan the last barcode that is used for the previous payment. Or the merchant can refresh the partner_trans_id to generate a new payment. If this error persists, contact Alipay technical support for help.
TRADE_HAS_CLOSE
Corresponding trade is closed, and is not allowed for the current operation.
Action:The merchant can send a new payment request.
TRADE_STATUS_ERROR
Corresponding trade status is not allowed for the current operation.
Action: The partner system needs to generate a new partner_trans_id request to Alipay. If a same error code is returned, use other payment method such as cash or the credit card.
EXIST_FORBIDDEN_WORD
Entered forbidden words according to China law.
Action:Partners need to check the content of the trans_name parameter.
SELLER_NOT_EXIST
The entered value for the alipay_seller_id parameter is not correct. No corresponding account can be found.
Action:Check whether the seller ID is correct
BUYER_NOT_EXIST
The entered value for buyer_identity_code is not correct.No corresponding account can be found.
Action:Ask the user to use other payment methods such as cash or the credit card
BUYER_ENABLE_STATUS_FORBID
The entered buyer account is disabled due to security issues.
Action:The user needs to complete the real-name validation accordingly.Users can contact Alipay CS hotline for help.Besides, Hong Kong and Macau residents or foreign residents are not supported.
BUYER_SELLER_EQUAL
The entered buyer account is equal to the seller account.
Action:Change user's Alipay account.
CLIENT_VERSION_NOT_MATCH
Client version doesn't match.
Action:Update the Alipay wallet to the latest version.
SOUNDWAVE_PARSER_FAIL
Incorrect barcode
Action:Ensure that users are using correct Alipay barcode or QR code. Besides, ask the cashier to check whether the scanner is handled correctly and make sure the cashier doesn't scan the user's barcode repeatedly.
CONTEXT_INCONSISTENT
The trade information is inconsistent.
Action:The merchant needs to check whether the request data are consistent with the previous one.
PRODUCT_AMOUNT_LIMIT_ERROR
Product quota exceeds.
Action:Contact Alipay technical support.
BUYER_BALANCE_NOT_ENOUGH
Alipay account of the buyer does not have enough balance for current operation.
Action:Cashier can ask the user to top-up the balance or bind a new bank card with sufficient fund.
TOTAL_FEE_EXCEED
Trade amount exceeds the limitation.
Action:The user needs to use the other payment method, such as cash or the credit card.
BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR
Total trade amount of the buyer exceeds the maximum amount allowed for a buyer in one day.
Action:The user needs to use the other payment method such as cash or the credit card.
BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR
Total trade amount of the buyer exceeds the maximum amount allowed for a buyer in one month.
Action:The user needs to use the other payment method such as cash or the credit card.
ERROR_BUYER_CERTIFY_LEVEL_LIMIT
Buyers failed to pass the PBOC (People's Bank of China) validation.
Action:The user needs to complete the real-name validation.
ERROR_SELLER_CERTIFY_LEVEL_LIMIT
The seller failed to passthe PBOC (People's Bank of China) validation.
Action:Merchants need to supplement the business license and some other materials (low possibilities for overseas partners).
PAYMENT_REQUEST_HAS_RISK
Current trade contains a risk detected by Alipay.
Action:Users can contact Alipay CS window for help or use other payment method such as cash or the credit card.
NO_PAYMENT_INSTRUMENTS_AVAILABLE
No available payment tool can be used for the current operation.
Action:Ask the user to pay again. If the issue persists, ask the user to contact Alipay technical support for help.
BUYER_BANKCARD_BALANCE_NOT_ENOUGH
Bank account of the buyer does not have enough balance for current operation.
Action:Ask the user to top up his/her Alipay account or use another bank card to pay for the order again.
PAYMENT_FAIL
The transaction is failed.
Action:The partner can retry the payment with the same partner_trans_id.
MOBILE_PAYMENT_SWITCH_OFF
The buyer switches off the mobile pay function, therefore, the operation cannot be performed.
Action:Users need to access to www.alipay.com, go to [账户管理] - [支付宝钱包设置], and enable [支付宝钱包支付].
USER_FACE_PAYMENT_SWITCH_OFF
The buyer switches off the face-to-face payment function,therefore, the operation cannot be performed.
Action:Ask the user to disable [付款码] at top right corner in his/her Alipay wallet, then switch it on again.
ERROR_BALANCE_PAYMENT_DISABLE
The buyer switches off the balance payment function, therefore, the operation cannot be performed.
Action:Users need to access to www.alipay.com, go to [账户管理] - [付款方式和额度], then switch on [账户支付功能].
EXCHANGE_AMOUNT_OR_CURRENCY_ERROR
The exchange amount or currency is not allowed for the current operation.
Action:Merchants need to check whether the amount and the currency parameter are correct.
ILLEGAL_SECURITY_PROFILE
Incorrect key profile.
Action:Make sure you upload your public keys before calling APIs.
ILLEGAL_EXTERFACE_FOR_CA_VERIFY
The interface is not allowed to use Certificate Verification Service.
Action:Contact Alipay technical support for help.
PULL_MOBILE_CASHIER_FAIL
Failed to call the mobile cashier.
Action:Contact Alipay technical support for help.
BEYOND_PAY_RESTRICTION
The payment limitation is exceeded.
Action:Users need to use the other payment method such as cash or the credit card.
NOT_SUPPORT_PAYMENT_INST
The Alipay Wallet version used by the buyer is not supported.
Action:Contact Alipay technical support for help.
INVALID_RECEIVE_ACCOUNT
The seller is not in the payee list.
Action:Contact Alipay technical support for help.
FORBIDDEN_MERCHANT_INDUSTRY
This transaction type is not allowed.
Action:Check the value of secondary_merchant_industry and contact Alipay technical support if needed.
ILLEGAL_MERCHANT_INDUSTRY
Illegal MCC format.
Action:Make sure the value of secondary_merchant_industry is defined in theMCC list.
CURRENCY_NOT_SUPPORT
The currency is not supported.
Action:Check your agreement with Alipay.
TRADE_TOTAL_FEE_ERROR
The total transaction fee is incorrect.
Action:Check the values of amount related parameters.
RESTRICTED_MERCHANT_INDUSTRY
The payment cannot exceed the certain amount in the industry.
Action:Check your agreement with Alipay.
ACCESS_FORBIDDEN
The merchant has no permission to use the product.
Action:Check your agreement with Alipay.
SECONDARY_MERCHANT_ID_BLANK
The secondary merchant ID is not provided to Alipay.
Action:Send the secondary merchant ID to Alipay.
SECONDARY_MERCHANT_ID_INVALID
The secondary merchant is not registered with Alipay.
Action:Check whether the provided secondary merchant ID is correct and whether the secondary merchant is registered with Alipay. If the secondary merchant is not registered with Alipay, register the secondary merchant with Alipay immediately.
STORE_NOT_MATCH
The secondary merchant is not registered with Alipay.
Action:Check whether the provided store ID is correct and whether the secondary merchant is registered with Alipay. If the secondary merchant is not registered with Alipay, register the secondary merchant with Alipay immediately.
SECONDARY_MERCHANT_STATUS_ERROR
The status of secondary merchant is abnormal in the Alipay system.
Action:Contact Alipay Business Support by sending an email to global.service@alipay.com.
