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.