This article contains the current error codes and provides links to the specific FAQ pages.
You have no permission to use the product. Check your agreement with Alipay.
See ACCESS_FORBIDDEN for details.
|AGREEMENT_NOT_EXIST||The related agreement does not exist. |
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 same external transaction number,
See ALIN42282 for details.
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.
See CONTACT_NO_MANDATORY for details.
The transaction information is inconsistent by the same
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.
See DISCORDANT_REPEAT_REQUEST for details.
More than one payment requests share a 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
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
See LBS_GEOGRAPHIC_INFORMATION_INVALID for details.
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
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.
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.
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.
See SELLER_NOT_EXIST for details.
The payment code (
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
Make sure the format of
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
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:
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
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.