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

Error codes

This article contains the current error codes and provides links to the specific FAQ pages.

Error codeDescription
ACCESS_FORBIDDEN

You have no permission to use the product. Check your agreement with Alipay. 

See ACCESS_FORBIDDEN for details.

AGREEMENT_NOT_EXISTThe related agreement does not exist. 

See AGREEMENT_NOT_EXIST for details.

ALIN10023

An order is being paid by a second payer. 

See ALIN10023 for details.

ALIN10070

The signature is incorrect. See ALIN10070 for details.

ALIN10129

In APP payment, the PID does not match the environment. For example, the PID is from production environment but is tested in sandbox environment.

See ALIN10129 for details.

ALIN38173

The orderInfo string in the request is not parsed correctly. See ALIN38173 for details.

ALIN42282

The same external transaction number, out_trade_no, is used to repeatedly initiate requests, and the request parameters are inconsistent.

See ALIN42282 for details.

ALIN43877

The merchant called Alipay domestic payment solution interface, but the buyer is trying to make payment in a foreign country (outside of China).

See ALIN43877 for details.

ALIN43911

Transaction risks are detected at the user side.

See ALIN43911 for details.

BEYOND_PAY_RESTRICTION

The balance payment amount exceeds the limit. Change to other payment method such as cash or credit card.

See ALIN43911 for details.

BUYER_BALANCE_NOT_ENOUGH

Insufficient balance for current operation. Top-up the balance or link a bank card.

See BUYER_BALANCE_NOT_ENOUGH for details.

BUYER_BANKCARD_BALANCE_NOT_ENOUGH

Insufficient bank balance for current operation. Top-up the balance or link a bank card.

See BUYER_BANKCARD_BALANCE_NOT_ENOUGH for details.

BUYER_ENABLE_STATUS_FORBID

The buyer account is disabled because of identity or security reasons.

See BUYER_ENABLE_STATUS_FORBID for details.

BUYER_NOT_EXIST

The buyer_identity_code value is incorrect.

See BUYER_NOT_EXIST for details.

BUYER_NOT_MAINLAND_CERT

The user is not an eligible customers of the Alipay payment products that you use.

See BUYER_NOT_MAINLAND_CERT for details.

BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR

The total payment amount for the buyer exceeded user daily max-amount limit. Change to other payment method such as cash or credit card.

See BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR for details.

BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR

The total payment amount for the buyer exceeded user monthly max-amount limit. Change to other payment method such as cash or credit card.

See BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR for details.

CONTACT_NO_MANDATORY

contact_no is not passed in the request parameters. 

See CONTACT_NO_MANDATORY for details.

CONTEXT_INCONSISTENT

The transaction information is inconsistent by the same out_trade_no. Check the request data.

See CONTEXT_INCONSISTENT for details.

CURRENCY_NOT_SAME

The refund currency is inconsistent.

See CURRENCY_NOT_SAME for details.

CURRENCY_NOT_SUPPORT

The currency is not supported. Check the agreement with Alipay.

See CURRENCY_NOT_SUPPORT for details.

DATA_NOT_EXIST

The secondary merchant is not successfully registered.

See DATA_NOT_EXIST for details.

DISCORDANT_REPEAT_REQUEST

The same out_return_no is used to initiate multiple refund requests, and the request parameters are inconsistent.

See DISCORDANT_REPEAT_REQUEST for details.

DUPLICATE_PAY_CURRENCY_NOT_EQUAL

More than one payment requests share a same out_trade_no, and the parameter currency is not the same.

See DUPLICATE_PAY_CURRENCY_NOT_EQUAL for details.

DUPLICATE_REQUEST

The registration request for the same PM / PMS is submitted already and is currently under review.

See DUPLICATE_REQUEST for details.

EXCHANGE_AMOUNT_OR_CURRENCY_ERROR

The exchange amount or currency is incorrect. Check the amount and the currency parameter.

See EXCHANGE_AMOUNT_OR_CURRENCY_ERROR for details.

EXIST_FORBIDDEN_WORD

Prohibited words are included in the transaction request.

See EXIST_FORBIDDEN_WORD for details.

HAS_NO_PRIVILEGE

The contract of the PID expires or is terminated.

See HAS_NO_PRIVILEGE for details.

ILLEGAL_ACCESS_SWITCH_SYSTEM

You are not allowed to access the system of this type. Contact Alipay Technical Support if needed.

ILLEGAL_ARGUMENT

The parameter is incorrect. Check each request parameter according to the API specification.

See ILLEGAL_ARGUMENT for details.

ILLEGAL_CLIENT_IP

The client IP address is illegal. Check the Client IP address.

See ILLEGAL_CLIENT_IP for details.

ILLEGAL_EXTERFACE

The Alipay API you call is incorrect.

See ILLEGAL_EXTERFACE for details.

ILLEGAL_PARTNER

The partner ID is incorrect. Ensure the value of partner parameter matches the partner value provided by Alipay.

See ILLEGAL_PARTNER for details.

ILLEGAL_PARTNER_EXTERFACE

The PID used in the request did not sign the corresponding contract.

See ILLEGAL_PARTNER_EXTERFACE for details.

ILLEGAL_SECURITY_PROFILE

The matching private key configuration is not found.

For the solution, see ILLEGAL_SECURITY_PROFILE.

ILLEGAL_SIGN

Errors exist in the signature.

See Digital signature for details.

ILLEGAL_SIGN_TYPE

Alipay's request only supports three signing methods: MD5, RSA, and RSA2. If other values are passed to sign_type, this error will be returned.

Please check if sign_type is one of MD5, RSA, RSA2, and check if the value is passed incorrectly.

INVALID_PARAMETER

The parameter name is wrong, the parameter value does not meet the requirements, and required parameters are not filled, and so on.

See INVALID_PARAMETER for details.

INVALID_RECEIVE_ACCOUNT

Error exists in the receipt account information.

See INVALID_RECEIVE_ACCOUNT for details.

INVALID_ROUNDED_AMOUNT

The refund with this amount may violate the rule that the calculated amount of both CNY and foreign currency should be fully or not fully refunded at the same time. Take a transaction with 0.07 CNY (0.01 USD) as an example. A refund with 0.06 CNY would not be accepted because this comes to a situation where there is 0.01 CNY (0 USD) left for this transaction.

See INVALID_ROUNDED_AMOUNT for details.

LBS_GEOGRAPHIC_INFORMATION_INVALID

The actual country of the address defined by store_address does not match the country defined by store_country, or the address defined by store_address cannot be found on Google Map.

See LBS_GEOGRAPHIC_INFORMATION_INVALID for details.

MCC_TYPE_ILLEGAL

MCC (parameter secondary_merchant_industry) is invalid.

See MCC_TYPE_ILLEGAL for details.

MOBILE_PAYMENT_SWITCH_OFF

The Payment Code feature is disabled in the customer's Alipay app.

See MOBILE_PAYMENT_SWITCH_OFF for details.

MORE_THAN_ALLOW_REFUND_FOREX_FEE

The principle of Alipay's split-refund is to return the original way. If a transaction involves refunding the split, and the refund amount exceeds the actual receipt amount of the account, this error code will be returned.

See MORE_THAN_ALLOW_REFUND_FOREX_FEE for details.

NOT_CERTIFIED_USER

Buyer qualifications do not match.

See NOT_CERTIFIED_USER for details.

NOT_PRIVATE_ACCOUNT_USER

The transaction can only be paid with the buyer's personal account, not the business account.

See NOT_PRIVATE_ACCOUNT_USER for details.

NOT_SUPPORT_PAYMENT_INST

The Alipay Wallet version is not supported.

See NOT_SUPPORT_PAYMENT_INST for details.

PARAM_ILLEGAL

The parameter is illegal. Modify the parameter according to the API document.

For more information about this error code in certain interfaces, see PARAM_ILLEGAL.

PAYER_ENABLE_STATUS_FORBID

The buyer's Alipay account is deactivated and the real-name verification information cannot be sent to the customs.

See PAYER_ENABLE_STATUS_FORBID for details.

PAYMENT_FAIL

The transaction failed.

See PAYMENT_FAIL for details.

PAYMENT_REQUEST_HAS_RISK

The merchant status is abnormal, or the buyer's payment has risks, such as offsite payment or large payment.

See PAYMENT_REQUEST_HAS_RISK for details.

PRODUCT_AMOUNT_LIMIT_ERROR

The transaction amount exceeded the limit.

See PRODUCT_AMOUNT_LIMIT_ERROR for details.

PULL_MOBILE_CASHIER_FAIL

Failed to call the mobile cashier.

See PULL_MOBILE_CASHIER_FAIL for details.

PURCHASE_TRADE_NOT_EXIST

The order for the refund request does not exist (status is TRADE_NOT_EXIST) or has not been paid (status is WAIT_BUYER_PAY).

See PURCHASE_TRADE_NOT_EXIST for details.

QRCODE_HAS_BEEN_EXIST

The QR code already exists. Try again or Contact Alipay Technical Support if needed.

See QRCODE_HAS_BEEN_EXIST for details.

REASON_TRADE_REFUND_FEE_ERR

Invalid refund amount.

See REASON_TRADE_REFUND_FEE_ERR for details.

REFUND_CHARGE_ERROR

The refund is initiated before Alipay receive the payment from the user.

See REFUND_CHARGE_ERROR for details.

REFUND_REQUEST_HAS_RISK

The merchant status is abnormal and transactions are not refundable.

See REFUND_REQUEST_HAS_RISK for details.

REFUNDMENT_VALID_DATE_EXCEED

The transaction exceeded the valid refund period.

See REFUNDMENT_VALID_DATE_EXCEED for details.

REGISTRATION_NO_MANDATORY

registration_no is not passed in the request parameters.

See REGISTRATION_NO_MANDATORY for details.

REPEATED_REFUNDMENT_REQUEST

Duplicated refund request. Please do not refund repeatedly.

See REPEATED_REFUNDMENT_REQUEST for details.

REQUEST_AMOUNT_EXCEED

The value of refund_amount or the total refund amount is more than the transaction amount.

See REQUEST_AMOUNT_EXCEED for details.

RESTRICTED_MERCHANT_INDUSTRY

The amount exceeded the merchant industry single order amount limit.

See RESTRICTED_MERCHANT_INDUSTRY for details.

RETURN_AMOUNT_ERROR

The refund amount in CNY, which is the value of return_rmb_amount, is less than 0.01 when converted to the settlement amount in foreign currency.

See RETURN_AMOUNT_ERROR for details.

RETURN_AMOUNT_EXCEED

The total refund amount exceeds the amount actually paid for the transaction.

See RETURN_AMOUNT_EXCEED for details.

SECONDARY_MERCHANT_ID_BLANK

No secondary merchant information was passed in the payment request.

See SECONDARY_MERCHANT_ID_BLANK for details.

SECONDARY_MERCHANT_ID_INVALID

The parameter secondary_merchant_id passed in the request is incorrect.

See SECONDARY_MERCHANT_ID_INVALID for details.

SECONDARY_MERCHANT_STATUS_ERROR

The secondary merchant status is abnormal.

See SECONDARY_MERCHANT_STATUS_ERROR for details.

SELLER_BALANCE_NOT_ENOUGH

When refunding, the seller's account balance was insufficient and the refund failed.

See SELLER_BALANCE_NOT_ENOUGH for details.

SELLER_NOT_EXIST

The parameter seller_id in the request is not consistent with partner. Or seller_email does not match partner.

See SELLER_NOT_EXIST for details.

SOUNDWAVE_PARSER_FAIL

The payment code (buyer_identity_code) is invalid.

See SOUNDWAVE_PARSER_FAIL for details.

SYSTEM_ERROR

Alipay system failed to process the request because of temporary internal glitch.

See SYSTEM_ERROR for details.

TARGET_SYSTEM_ERROR

For interface alipay.acquire.overseas.spot.pay, parameter extend_info is not in JSON format.

Make sure the format of extend_info is JSON.

TOTAL_FEE_EXCEED

The transaction amount exceeds the limit.

See TOTAL_FEE_EXCEED for details.

TRADE_BUYER_NOT_MATCH

The buyer does not match.

See TRADE_BUYER_NOT_MATCH for details.

TRADE_CANCEL_TIME_OUT

The cancellation request is beyond the opening hours.

See TRADE_CANCEL_TIME_OUT for details.

TRADE_HAS_CLOSE

Payment or refund is not allowed for orders with a status of TRADE_CLOSED.

See TRADE_HAS_CLOSE for details.

TRADE_HAS_FINISHED

The transaction is successfully paid and the refund period has expired. No payment or cancel request is allowed.

See TRADE_HAS_FINISHED for details.

TRADE_HAS_SUCCESS

Already successful transactions are not allowed to initiate a payment again.

See TRADE_HAS_SUCCESS for details.

TRADE_NOT_EXIST

The transaction does not exist.

See TRADE_NOT_EXIST for details.

TRADE_SETTLE_ERROR

The error might be caused by the following reasons:  

  • Errors exist in split_fund_info. For example, the value of transOut is incorrect.
  • Multiple partial refunds are requested within a same second.
  • Network jitter occurs during the settlement.

See TRADE_SETTLE_ERROR for details.

TRADE_STATUS_ERROR

The corresponding transaction status is not allowed for current operation.

See TRADE_STATUS_ERROR for details.

UNKNOW

In the in-store payment, if the amount is small and confidential, payment is returned to SUCCESS. If the amount is large, the confirmation payment page will be invoked, and the return code is UNKNOW.

See UNKNOW for details.

UNKNOW_ERROR

The service is temporarily unavailable.

Try again later.

购汇金额或币种错误

The transaction amount in transaction currency is rounded to 0 in the settlement currency.

See 购汇金额或币种错误 for details.

系统有点儿忙,一会儿再试试,或者可以在电脑上付款

The customer cannot use Alipay Global Payment Products.

See 系统有点儿忙…… for details.