This section describes only module-specific error codes. For details about universal error codes, please refer to Universal Error Codes.
If the issue persists, submit a ticket online. Huawei will get back to you as soon as possible.
Message
The operation was canceled by the user.
Description
The user canceled the current operation.
Possible Causes
The user canceled the current operation.
Solution
Display a message to the user that the operation is canceled.
Message
System internal error.
Description
Internal system error.
Possible Causes
The DevEco Studio version is earlier than DevEco Studio 6.0.1 Release, or the HarmonyOS SDK version is earlier than HarmonyOS 6.0.1 Release SDK.
The JWT signature is invalid or has expired.
The signature for promotion is used, but the nonce field is repeatedly used.
IAP Kit is not enabled.
Solution
Ensure that DevEco Studio has been updated to DevEco Studio 6.0.1 Release or later and the HarmonyOS SDK has been updated to HarmonyOS 6.0.1 Release SDK or later.
Check the validity of the JWT signature and ensure that the JWT is within the validity period. For details, please refer to Generating a Signed Purchase Parameter for a Promotion.
If the signature for promotion is used, ensure that the nonce field is unique. For details, see OfferInfo.
Ensure that IAP Kit is enabled and activated by referring to Enabling and Activating IAP Kit.
In other cases, try again or submit a ticket online.
Message
The application is not authorized.
Description
The app is not authorized to call the API.
Possible Causes
The app signature or identity information is incorrectly configured.
The app does not have the IAP service enabled.
Solution
Check relevant items by referring to Configuring App Identity Information and (Conditionally mandatory) Adding a Public Key Fingerprint.
Check whether the automatic signing mode is used by referring to Configuring Signing Information. If so, use the manual signing mode.
To use the IAP service, you must enable and activate it. For details, please refer to Enabling and Activating IAP Kit.
The system reports different error information based on the actual error cause. The details are as follows:
Message
Invalid product information. Failure reason: Product status is not online.
Description
The product is offline.
Possible Causes
The status of the created product is abnormal (draft, to be submitted, or rejected).
Solution
Sign in to AppGallery Connect. Click Apps and atomic services, select the app to which the product belongs from the app list, and go to Operate > Product Management > Products. Then, check whether the product exists and is correct and whether the product information has been submitted for review and approved. If the product is not approved, you can use a sandbox account to test the product. For details, please refer to Sandbox Testing.
Message
Invalid product information. Failure reason: The product type or product id does not match.
Description
The product type or ID does not match.
Possible Causes
The transferred product ID or type is incorrect, or the product price is not configured.
Solution
Sign in to AppGallery Connect. Click Apps and atomic services, select the app to which the product belongs from the app list, and go to Operate > Product Management > Products. Then, check whether the product ID and type are correct and whether the product price has been configured.
Message
The application is not authorized. Failure reason: The In-App Purchases Service is not activated.
Description
IAP Kit is not activated.
Possible Causes
IAP Kit is not enabled.
Solution
Ensure that IAP Kit is enabled and activated by referring to Enabling and Activating IAP Kit.
Message
Too frequent API calls.
Description
API calls are too frequent.
Possible Causes
The API call interval is too short.
Solution
Control the API call frequency. The current default interval for accessing this API is 5 seconds. In the future, IAP Kit may adjust the call frequency limit up or down as needed.
Message
Network connection error.
Description
The network is abnormal.
Possible Causes
Check the network.
Solution
Display a message to users, asking them to check the network.
Message
The app to which the product belongs is not released in a specified location.
Description
The app to which the product belongs is not released to specified countries or regions.
Possible Causes
The app to which the product belongs is not released to specified countries or regions.
Solution
Sign in to AppGallery Connect. Click My apps, select an app, and go to Distribute > Version information > Draft. Then, check the countries or regions to which the app will be released.
Message
The HUAWEI ID is not signed in.
Description
No HUAWEI ID is signed in.
Possible Causes
No HUAWEI ID is signed in.
Solution
Guide the user to sign in with a HUAWEI ID.
Message
Failed to purchase a product because the user already owns the product.
Description
The purchase failed because the user already owns the product.
Possible Causes
The product has already been purchased.
Solution
You can use the queryPurchases API to check whether the user has purchased the product.
If the product is a consumable or non-renewable subscription, check whether it has been delivered. If the product has been delivered, call the finishPurchase API to complete the purchase so that the product can be purchased again in the future.
If the product is a non-consumable or auto-renewable subscription, it can only be purchased once.
Message
The purchase cannot be finished because the user has not paid for it.
Description
Failed to deliver the product because the user has not paid for it.
Possible Causes
The user has not purchased the product.
Parameter transfer error.
Solution
You can use the queryPurchases API to check whether the user has purchased the product.
Check whether the input parameters of the API that reports the error are correct.
Message
The purchase has been finished and cannot be finished again.
Description
The product has been delivered. No more delivery is needed.
Possible Causes
The product has been delivered. No more delivery is needed.
Solution
You can call the queryPurchases API to check whether there is a delivery acknowledge record of the product.
Message
The country or region of the signed-in HUAWEI ID does not support IAP.
Description
The country or region to which the signed-in HUAWEI ID belongs is not supported by IAP Kit.
Possible Causes
The country or region to which the signed-in HUAWEI ID belongs is not supported by IAP Kit.
Solution
For signed-in HUAWEI IDs whose service area is not within the Chinese mainland, you are advised to hide IAP Kit-related functions within your app.
Message
The user is not allowed to make purchase.
Description
The user transaction is rejected.
Possible Causes
The transaction behavior triggers IAP Kit's risk control.
Solution
Try again later or change the payment method.
Message
The app provision type is not debug.
Description
The app is not signed with a debug certificate.
Possible Causes
The app is not signed with a debug certificate.
Solution
Build the app signed with a debug certificate by following these steps:
Manual signing: You need to apply for a debug certificate in AppGallery Connect, register a debug device, apply for a debug profile, and then manually configure the signing information.
Message
The HUAWEI ID is not test account.
Description
The signed-in HUAWEI ID is not a test account.
Possible Causes
The HUAWEI ID is not configured as a test account under Users and permissions in AppGallery Connect.
Solution
Configure a test account under Users and permissions in AppGallery Connect. For details, please refer to Preparing for Sandbox Testing.
Message
Invalid promotional offer id.
Description
Invalid special offer information.
Possible Causes
Promotional offers for custom user groups are not configured for the product during the task of configuring product information.
Solution
You can use the queryProducts API to check whether there are promotional offers set for the product. For details, please refer to Setting Promotional Prices.
Message
Invalid purchase signature.
Description
Invalid signature information.
Possible Causes
The signing key or signing parameters are invalid, or the signing process failed.
Solution
You can refer to Generating a Signed Purchase Parameter for a Promotion for the signing process.
Message
The purchase has been refunded or in refund.
Description
The product has been refunded or is being refunded.
Possible Causes
The product has been refunded or is in the process of being refunded.
Solution
Configure your app to guide users to the order details page to view the refund status.
Message
Refund is not allowed.
Description
The order cannot be refunded.
Possible Causes
Refunds are not available for this order. Currently, the refund API integrated in the app is applicable only to non-game scenarios.
Solution
Make sure that the refund entry is unavailable in game scenarios.
Message
The purchase order is not found for the signed-in HUAWEI ID.
Description
The purchase order cannot be found under the currently signed-in HUAWEI ID.
Possible Causes
The HUAWEI ID currently signed in does not match the account associated with the order, or the order does not exist.
Solution
Check whether the HUAWEI ID signed in on the device matches the app account associated with the order, and verify that the provided order number is correct.
Message
The operation is not supported.
Description
The operation is not supported.
Possible Causes
Solution
Check whether the order has any of the issues listed above.