Error codes

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

See ACCESS_FORBIDDEN for details.

See AGREEMENT_NOT_EXIST for details.

An order is being paid by a second payer. 

See ALIN10023 for details.

The signature is incorrect. See ALIN10070 for details.

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.

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

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.

Transaction risks are detected at the user side.

See ALIN43911 for details.

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

See ALIN43911 for details.

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

See BUYER_BALANCE_NOT_ENOUGH for details.

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

See BUYER_BANKCARD_BALANCE_NOT_ENOUGH for details.

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

See BUYER_ENABLE_STATUS_FORBID for details.

The buyer_identity_code value is incorrect.

See BUYER_NOT_EXIST for details.

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

See BUYER_NOT_MAINLAND_CERT for details.

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.

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 is not passed in the request parameters. 

See CONTACT_NO_MANDATORY for details.

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

See CONTEXT_INCONSISTENT for details.

The refund currency is inconsistent.

See CURRENCY_NOT_SAME for details.

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

See CURRENCY_NOT_SUPPORT for details.

The secondary merchant is not successfully registered.

See DATA_NOT_EXIST for details.

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

See DISCORDANT_REPEAT_REQUEST for details.

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.

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

See DUPLICATE_REQUEST for details.

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

See EXCHANGE_AMOUNT_OR_CURRENCY_ERROR for details.

Prohibited words are included in the transaction request.

See EXIST_FORBIDDEN_WORD for details.

The contract of the PID expires or is terminated.

See HAS_NO_PRIVILEGE for details.

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

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

See ILLEGAL_ARGUMENT for details.

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

See ILLEGAL_CLIENT_IP for details.

The Alipay API you call is incorrect.

See ILLEGAL_EXTERFACE for details.

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

See ILLEGAL_PARTNER for details.

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

See ILLEGAL_PARTNER_EXTERFACE for details.

The matching private key configuration is not found.

For the solution, see ILLEGAL_SECURITY_PROFILE.

Errors exist in the signature.

See Digital signature for details.

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.

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.

Error exists in the receipt account information.

See INVALID_RECEIVE_ACCOUNT for details.

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.

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 (parameter secondary_merchant_industry) is invalid.

See MCC_TYPE_ILLEGAL for details.

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

See MOBILE_PAYMENT_SWITCH_OFF for details.

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.

Buyer qualifications do not match.

See NOT_CERTIFIED_USER for details.

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

See NOT_PRIVATE_ACCOUNT_USER for details.

The Alipay Wallet version is not supported.

See NOT_SUPPORT_PAYMENT_INST for details.

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.

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.

The transaction failed.

See PAYMENT_FAIL for details.

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.

The transaction amount exceeded the limit.

See PRODUCT_AMOUNT_LIMIT_ERROR for details.

Failed to call the mobile cashier.

See PULL_MOBILE_CASHIER_FAIL for details.

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.

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

See QRCODE_HAS_BEEN_EXIST for details.

Invalid refund amount.

See REASON_TRADE_REFUND_FEE_ERR for details.

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

See REFUND_CHARGE_ERROR for details.

The merchant status is abnormal and transactions are not refundable.

See REFUND_REQUEST_HAS_RISK for details.

The transaction exceeded the valid refund period.

See REFUNDMENT_VALID_DATE_EXCEED for details.

registration_no is not passed in the request parameters.

See REGISTRATION_NO_MANDATORY for details.

Duplicated refund request. Please do not refund repeatedly.

See REPEATED_REFUNDMENT_REQUEST for details.

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

See REQUEST_AMOUNT_EXCEED for details.

The amount exceeded the merchant industry single order amount limit.

See RESTRICTED_MERCHANT_INDUSTRY for details.

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.

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

See RETURN_AMOUNT_EXCEED for details.

No secondary merchant information was passed in the payment request.

See SECONDARY_MERCHANT_ID_BLANK for details.

The parameter secondary_merchant_id passed in the request is incorrect.

See SECONDARY_MERCHANT_ID_INVALID for details.

The secondary merchant status is abnormal.

See SECONDARY_MERCHANT_STATUS_ERROR for details.

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

See SELLER_BALANCE_NOT_ENOUGH for details.

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.

The payment code (buyer_identity_code) is invalid.

See SOUNDWAVE_PARSER_FAIL for details.

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

See SYSTEM_ERROR for details.

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

Make sure the format of extend_info is JSON.

The transaction amount exceeds the limit.

See TOTAL_FEE_EXCEED for details.

The buyer does not match.

See TRADE_BUYER_NOT_MATCH for details.

The cancellation request is beyond the opening hours.

See TRADE_CANCEL_TIME_OUT for details.

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

See TRADE_HAS_CLOSE for details.

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

See TRADE_HAS_FINISHED for details.

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

See TRADE_HAS_SUCCESS for details.

The transaction does not exist.

See TRADE_NOT_EXIST for details.

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.

The corresponding transaction status is not allowed for current operation.

See TRADE_STATUS_ERROR for details.

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.

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.