Intelligent Assistant
Chat with our virtual assistant to get answers promptly.
Documents from this version have been archived, and will not continue to be maintained. Please use the latest version.
In-App Purchases FAQs
Content overview
Troubleshooting During the Development Preparations
1. What should I do if a 6003 error occurs when I try to connect to HMS Core (APK)?
Error code 6003 is caused by inconsistent certificate fingerprint configurations. Check the following items:
Ensure that the certificate fingerprint has been configured, and the certificate for packing the signature on the local client is the same as the certificate for configuring the fingerprint in AppGallery Connect.
Check the fingerprint entries in the certificate. It is recommended that you use a single entry.
If error code 6003 persists when you run the local client after the fingerprint is configured, the debug certificate is running by default. Clear the cache of HUAWEI HMS Core (APK) and run the client again.
2. The signature algorithm of the app signature certificate is SHA1withRSA. Does this have any impact on the app?
Yes. Currently, the required algorithm is SHA256.
3. Which libraries need to be imported when connecting to HUAWEI IAP?
The IAP and Base libraries need to be imported.
4. Do I need to configure a result callback address?
No callback address needs to be configured for consumables and non-consumables. However, for subscriptions, you can configure a callback address or not.
5. Under Develop > Earning > In-App Purchases on the console, is the subscription notification address mandatory?
This parameter is optional. It is mandatory only when a key subscription event is sent to your server using a callback.
6. When the IAP function is enabled on the console, a message is displayed, indicating that the merchant authentication fails and you need to contact the merchant representative. Why does this issue occur and what should I do?
This message is displayed because you have no permission using this account.
7. What is the format of the public payment key obtained from AppGallery Connect? PKCS1 or PKCS8?
PKCS8.
8. Can the public payment key be exposed on the app?
Yes. It is recommended that the app obtain the public payment key from your server in real time. Do not store it on the app to prevent app version incompatibility caused by subsequent key upgrade.
9. Can I set multiple callback addresses for a key subscription event on the Huawei console?
No, you cannot.
10. When the app calls the payment API, the message "can't get applicationInfo by applicationId" is displayed. Why does this issue occur and what should I do?
This message indicates that HUAWEI IAP is not enabled or is enabled abnormally. You need to enable HUAWEI IAP and set the service parameters.
Go to Develop > Earning > In-App Purchases on the console, check whether a public payment key is generated. If not, generate one.
For details, please refer to Enabling Services.
11. What is the maximum length of the IAP public key obtained on the console? Some have more than 400 characters, and others have more than 500 characters. Can you provide the maximum length to facilitate our storage settings?
The length depends on the specifications of the key. It will be optimized to 3072 characters or more. You are advised to store the key in the text type in the database.
12. What is the meaning of the default price on the page for editing product prices in the PMS?
The default price is used when product prices are displayed on other pages.
13. If the price of a country or region is changed in the PMS background, will the price of an in-app product be affected if the exchange rate changes?
No, unless you change it.
14. Is the price displayed in the PMS digitally processed? For example, the second decimal point is processed as 6 or 9.
Yes. For details, please refer to Conversion Rule Description.
15. How do I obtain the public key for signature verification through the IAP?
If the HMS Core IAP SDK version is earlier than 3.0, obtain the public key for signature verification by referring to the related document.
For other versions, please refer to Querying IAP Information.
Troubleshooting During the Development
1. What should I do if the signature fails to be verified on the server side?
Perform self-check on the following items:
Check whether the public key has a typesetting problem when being used in different languages and versions.
Example: In the PHP version, if each line contains 32 characters, the signature can be verified. If each line contains 64 characters, the signature fails to be verified. In this case, the carriage return in each line must be a hard return.
2. Can the signature verification be executed on the server?
If you have deployed a server, you are advised to perform signature verification on the server.
3. Is the SHA-256 certificate mandatory for signature verification?
Yes. HUAWEI Developers requires the SHA-256 certificate fingerprint.
4. Why is error code -1 returned when the app calls the createPurchaseIntentWithPrice API?
The possible causes are as follows:
Under Develop > Earning > In-App Purchases on the console, no public payment key is generated.
The API request parameters are incorrect.
The transferred country/region code and currency are incorrect.
5. Why is error code 1203 (sub-error code 12303) returned when my server calls the API for verifying the purchase token for the order service?
Error code 1203 indicates that the request parameter is incorrect. Sub-error code 12303 indicates that client_id in the request does not exist in the system. For details, please refer to Open Platform Authentication.
Note: Ensure that the value of client_id in the request is the same as of appid and the value of client_secret is the same as that of appsecret.
6. When my server calls the API for verifying the purchase token for the order service, the message "missing required parameter: client_id" is displayed, and "sub_error": 20001,"error_description": "missing required parameter: client_id","error": 1102 is returned. In this case, what should I do?
The request header of this API needs to be authenticated using AccessToken. Currently, Huawei provides two authentication modes, of which the app password mode is used for this API. You are advised to check whether the obtaining method is correct based on Open Platform Authentication.
7. When my server calls the API for verifying the purchase token for the order service, {"responseCode":"6","responseMessage":"rights invalid"} is returned. In this case, what should I do?
You are advised to check whether the app ID used for obtaining AccessToken is the same as the app ID associated with purchaseToken in the request.
8. Is there any payment callback in the HMS Core SDK 4.0?
No. The app APK needs to proactively notify your server after the payment is complete. Your server uses the API in Verifying the Purchase Token for the Order Service to proactively request Huawei to verify the order status.
9. When my server calls the API for verifying the token for the order service, the following message is displayed: responseCode:"6","responseMessage":"900030-authorization format invalid". Why does this issue occur?
This message indicates that the signature verification data format is invalid. The possible causes are as follows:
The token in the request header is not encrypted in Base64 mode.
The character string APPAT is not appended before the access token for authorization. The correct access token is similar to APPAT:thisIsAppAtVaule.
For details, please refer to the API specifications.
10. After a user purchases a subscription, the Huawei IAP server sends a key subscription event notification to my server. Why is the value of the notificationType field returned by the API is 9?
Value 9 indicates that an expired subscription enters the account retention period.
When a user purchases a subscription, the third-party system deducts the fee, but the Huawei server does not receive a payment success response for a long time. As a result, the order times out. In this case, the Huawei server sends an onhold notification (the value of notificationType is 9) to the app.
11. After a user purchases a subscription, {"responseCode":"6","responseMessage":"paymentToken siteID invalid"} is returned when my server calls the API for verifying the purchase token for the order service. Why does this issue occur?
This API is used for non-subscriptions. For details about the API for subscriptions, please refer to Purchase Token Verification for the Subscription Service.
12. Is there a restriction on the frequency of access token requests during the purchase token verification?
According to the requirement, the flow control is performed on too frequent requests. The validity period of the access token is 3,600 seconds. An access token can be reused within the validity period. The app needs to apply for a new access code in advance based on the validity period.
13. When is the obtainOwnedPurchases API called?
When an app launches, call the obtainOwnedPurchases API to check whether the delivery failure occurs. If so, redeliver the corresponding products. After the successful redelivery, call the consumeOwnedPurchase API to consume them.
If an exception occurs during a payment, call the obtainOwnedPurchases API to check whether the payment is successful. If the delivery failure occurs, redeliver the corresponding product.
If a product has been purchased but is not consumed, error code 60051 is returned during the payment. In this case, call the obtainOwnedPurchases API to check whether the delivery failure occurs. If so, redeliver the corresponding product.
14. Is the purchase token valid for a long time in the API called by my server to check the validity of the purchase token?
No. Currently, the purchase token is valid for 30 days.
15. Why is error code 401 returned when my server calls the API for verifying the purchase token for the order service?
The access token becomes invalid. You are advised to obtain a new access token.
16. If a non-consumable fails to be delivered after payment, how do I know whether the product has been delivered when I call the obtainOwnedPurchases API to query failed orders?
Non-consumables do not need to be consumed after payment. Currently, all purchased non-consumables are returned through the obtainOwnedPurchases API. That is, these products provide services all the time. You can determine whether the non-consumables have been delivered. The product that has provide the service needs to continue providing (which depends on your design). The product that has not been confirmed needs to be delivered and confirmed. For details, please refer to Providing the Services of a Non-Consumable Product.
17. Can my app find the inactivated product through obtainProductInfo?
During common product query, only activated products are returned. For subscriptions, all are returned. The returned products can be distinguished based on the status field in the returned product information.
18. In a renewal scenario, how can I associate my request ID?
In a renewal scenario, subscriptionId identifies the one-to-one mapping between users and products. Therefore, the value of this field does not change. You can use this field to identify your request ID.
For example, the payment API needs to be called upon successful first payment of a subscription. The API request contains the developerPayload field. You can use this field to associate the custom request ID. After the payment is complete, subscriptionId is obtained. Your server saves the association between the three fields.
After the successful renewal, Huawei will send you a key subscription event notification, including the subscription ID (associated with the user and product, which is unchanged) and the new order ID generated by Huawei.
In this case, you can use the subscription ID to find developerPayload (request ID) for the first subscription purchase.
19. Is there an upper limit on the number of product records queried by obtainProductInfo?
Yes. A maximum of 200 records are recommended.
20. When the API is called for verifying the purchase token for the order service, multiple servers obtain access tokens. Are one token or multiple tokens valid at the same time?
Each token is independent and valid within its validity period. However, your server can apply for up to 2 access token within one hour; otherwise, the flow control will be triggered.
If multiple servers exist or multiple processes are started on a server and you have applied for an access token, handle the fault by referring to App-Level Access Token Sharing and Reuse Solutions.
Troubleshooting During the Test
1. What should I do if a 907135702 error occurs when I try to connect to HMS Core (APK)?
You need to configure the certificate fingerprint on HUAWEI Developers.
2. Troubleshooting during the non-consumable testing
Will a purchased non-consumable be reset and can be purchased again when the APK is reinstalled?
No. The purchase of the non-consumable is recorded on the Huawei IAP server. Reinstalling the APK does not affect the purchase record.
Will the purchase of a non-consumable be automatically canceled after a period of time?
No.
Can I manually cancel the purchase of a non-consumable to avoid creating a separate tester account for each test?
In the sandbox testing, you can call the consumption API to consume the non-consumable. After the non-consumable is consumed successfully, you can purchase it again without creating multiple tester accounts.
3. Can I use a non-Huawei phone to perform the test?
Yes. However, the HMS Core (APK) must be installed on the test device. Otherwise, the service cannot run properly. To ensure stability, it is recommended that you use Huawei devices for the test.
4. A sandbox testing account has been added to the console. Why is the sandbox testing function still not used?
The sandbox testing function can be used only when the following conditions are met: A sandbox testing account is successfully added, and the value of versionCode of the test package is greater than that of the released package. In the HMS Core IAP SDK 4.0.2, the isSandboxActivated API is added to check whether the current sandbox testing environment is available. If not, the API returns the reason why the environment is unavailable. For details, please refer to Sandbox Testing.
5. In the sandbox testing environment, the app displays the payment page, and I tap the back button. When I purchase the product again, the system displays a message indicating that the product already exists. Is this a normal situation?
Yes. This is a normal situation.
6. When a user uses a bank card to pay for a transaction in the app, an error message is displayed, indicating that the transaction is rejected, and the user needs to try again later, or try other payment methods. Why does this issue occur?
Possible cause: The payment using this bank card is under risk control. It is recommended that the user change the payment method or use another bank card.
7. In the sandbox testing environment, will the console report record the payment success?
No. Only real payments are recorded.
8. The payment page cannot be displayed on a non-Huawei mobile phone, and error code 1 or 907135003 is returned. In this case, what should I do?
Non-Huawei phones have compatibility issues. You are advised to use Huawei phones for testing. For some third-party phones, you can perform the following operations to solve this issue:
Check whether HMS Core (APK) is installed on the mobile phone.
Enable the HMS Core (APK) permission on the mobile phone.
9. In the sandbox testing environment, after a successful payment, the value of subIsvaild is false. Why does this issue occur? (If the value is true, the subscription has been charged and has not expired, and no refund has been made. You can provide services for users based on the value of subIsvaild. Value false indicates that the purchase is not complete, the subscription has expired, or the refund has been made.)
A subscription can be renewed for a maximum of six times in the sandbox testing environment. After that, the subscription cannot be renewed again and is in expired state. This restriction does not apply to the real environment.
10. What are the differences in payment between the sandbox testing environment and the real environment?
When you pay for a subscription in the sandbox testing environment, no fee is deducted, the subscription period is shortened, and the subscription can be renewed for a maximum of six times.
11. Is no fee deducted for purchasing non-subscriptions in the sandbox testing environment?
Yes. Other information is the same as that in the real environment, for example, there is a key event notification callback for purchasing subscriptions.
12. Why is Alipay rather than WeChat Pay available as a payment method?
For WeChat Pay, contact Huawei operations personnel to submit an entrusted payment application. For details, contact Huawei operations personnel.
13. When I call the API for verifying the purchase token for the order service, purchaseTokenData is returned. In the data, does the price field indicate the actual top-up amount of the user? If multiple payment modes are combined, such as combining with a coupon, is the actual payment amount or the sum of the actual payment amount and the coupon returned?
The sum is returned.
14. How long will my server receive a notification about a key subscription event?
Your server will receive the notification in real time. After the app triggers an event, the Huawei server notifies your server within several seconds.
15. What should I do if the payment page is not displayed for a long time when the app calls the payment API? If the payment page is not displayed within 10 seconds, the user is allowed to open the payment page again. As a result, two payment pages are displayed. In this case, is there any API used to cancel the previous payment API call or when will a response of the previous call be returned?
Currently, calling the payment API and opening the payment page are separated. If the payment API does not return a response for a long time due to a network issue, you can allow the user to open the payment page repeatedly. However, you also need to handle the previous payment API call response to prevent the page from being opened twice.
16. Assume that 24:00 on March 31 is the subscription end time, but the fee deduction is successful for renewal on April 3 in the lapse period. Is the renewed subscription end time April 30 or May 3?
The time starts from the day when the fee is deducted successfully, that is, May 3.
17. What should I do if the system displays a message indicating that the HUAWEI IAP is unavailable when a user makes a payment in my app released outside the Chinese mainland?
The possible causes are as follows:
The service area of the HUAWEI ID does not support HUAWEI IAP (To view the service area, go to AppGallery > Me > Settings > Country/Region). For details about the countries or regions that support IAP, please refer to Supported Countries and Regions.
The createPurchaseIntentWithPrice API used for payment is not a hosted API. The app needs to use the hosted API createPurchaseIntent outside the Chinese mainland.
Troubleshooting in Other Cases
1. Is there only one payment UI? Is there any other payment UI?
Currently, there is only one payment UI.
2. Is there any restriction on the maximum payment amount in HUAWEI IAP?
Yes. You can configure the maximum payment amount in the PMS based on the in-app product price template.
3. Is there any difference between the signature and signature verification algorithms?
The signature algorithm must be SHA-256. The signature verification algorithm can be determined based on the signType parameter in the callback result.
4. Is refund allowed in the background after a payment?
Yes. You can sign in to HUAWEI Developers. Click Console in the upper right corner. On the displayed console, go to My Reports > HUAWEI IAP, and manually apply for a refund. The above operations are allowed only when you have the refund permission.
5. Does the HMS Core SDK 4.0 need to transfer an order number for payment? The HMS Core SDK 2.0 needs to transfer.
In the HMS Core SDK 4.0, all orders are managed by Huawei. That is, Huawei returns the order numbers for which users complete payment to you. For details about the payment request fields, please refer to the HMS Core SDK 4.0 document.
6. Is a report viewed in real time on the Huawei console?
No, it is viewed the next day.
7. When is the merchant request ID uploaded, which is displayed in the console order report?
The merchant request ID is the unique ID generated by the Huawei server after the app calls the createPurchaseIntent or createPurchaseIntentWithPrice API to initiate a payment request. The ID is returned to the client.
8. What process will be triggered if I click the redelivery button on the console order report for the order when the delivery failed?
HMS SDK 2.0: Click the button to trigger the Huawei payment server to send a payment success callback to your server.
HMS SDK 4.0: Click the button to trigger the Huawei payment server to send a payment success callback to the Huawei IAP server. You will not receive the payment success callback.
9. Which field in the HMS Core SDK API or my server is used to report the merchant request ID to the console payment report?
In the HMS Core SDK 4.0, order IDs are fully managed. After a payment is complete, the Huawei server generates a Huawei order ID (specified by payorderId) or merchant request ID (specified by requestId or orderId) and returns it to your app.
The createPurchaseIntent API returns payorderId and orderId, which correspond to Huawei order ID and merchant request ID in the console report.
10. What are the principles for displaying the product price and unit on a user's mobile phone? Based on the player's location?
The app displays the local price and unit based on the service area to which the current HUAWEI ID belongs. (To view the service area, go to AppGallery > Me > Settings > Country/Region.)
11. Can a user use a subscription for free for a period of time?
Yes. When creating a subscription in AppGallery Connect, you can set the promotional price to free of charge. The promotional price can be free of charge or a discounted price.
12. Can a user pay for a subscription by HUAWEI Points?
In the Chinese mainland: Only WeChat and Alipay are supported.
If the user's service area supports HUAWEI Points, the user can purchase a subscription by HUAWEI Points. However, the user needs to set the payment mode used first in the payment and bill, and select HUAWEI Points. At the same time, the user needs to select the bank card or DCB. If the user's service area supports HUAWEI Points, the user cannot purchase a subscription by HUAWEI Points.
13. What is the renewal period of a subscription? For example, if the renewal period is one month, are a fixed number of days or the actual number of days in the month used?
Actual number of days in the month.
14. Is there any restriction, such as QPS flow control, on the API for verifying the purchase token for the order service?
There is no restriction currently. The restriction may be planned in the future.
15. Will a user receive an SMS message before the fee is deducted for automatic renewal?
No, they won't.
16. How long is the validity period of purchaseToken?
30 days.
17. Will Huawei automatically refund for a consumable that has been paid but the app has not called the consumption API for a long time?
No. The order is retained until it is redelivered successfully.
This page may contain third-party content. For details, click here.
Search in Guides
Enter a keyword.