DocumentationError Codes

Error Codes

This page lists the error codes that may be returned by the SDK and their meanings. Each error code includes a description and suggested resolution steps.

System errors

This section details the specific error codes that can be returned directly by the VNGGames SDK. These errors typically indicate issues originating from the SDK’s internal logic or its interactions with the underlying operating system or network services.

Error CodeOverview
9000Cause: Unknown error
Solution:
Please send a reproduction video to the support team
9001Cause: Network error
Solution:
- Check if the VPN is enabled outside of China
- Check the GameID in the PassSDK.json/GTSDK.json config => Incorrect GameID will not call bootstrap
9001-2Cause: Error occurs when the API call process fails. Reason due to inability to parse data or BE returns an undetermined error
Solution:
If AppTransID is empty, it is mandatory to pass a value (e.g., RoleID)
9001-7Cause: Error occurs when the process of calling query product detail fails during the payment process
Solution:
- Ensure the correct Sandbox account is used. You need to get test account information and ask the Store team to check tester and sandbox list
- Ensure the correct region is set on the Store. Tester must ensure they have VPNed into the correct valid region. The list of regions can be checked by the Store team
- Log out of the current account, clear the application cache, log back into the sandbox account
9002Cause: Server returned incorrect data
Solution:
Check the keystore; you must use the keystore provided by the Store team.
9004Cause: Server sig and Client sig are different when handling the result of Apple login
Solution:
Check the keystore; you must use the keystore provided by the Store team.
9005Cause: Cannot refresh Google token
Solution:
Kill the app, clear cache, and try again
9006Cause: Invalid payment information
Solution:
Check userId, itemId passed into PaymentInfo in the integration code
9007Cause: Store cannot find item
Solution:
- Check package name/bundleID
- Check if the item has been declared
- Check sandbox account
9008Cause: User clicks to buy an item being verified
Solution:
The item is being verified, try again after 30 minutes. If the error persists, collect userId, itemId, gameId and contact the support team
9010Cause: Error when not logged into CH Play. Only occurs when using IAP feature (as IAP requires a CH Play account)
Solution:
Log in to Play Store using Sandbox account, clear Play Store cache, and try again.
9011Cause: Retrieve rewarded item information with Store but not found on Android.
Solution:
Collect userId, itemId, gameId and contact the Store team for support.
9012Cause: This item package has already been purchased
Solution:
User has purchased this package, cannot continue to buy
9013Cause: When the user clicks to buy an item that Google has marked as PURCHASED but is waiting for verification
Solution:
Collect userId, itemId, gameId and contact the Payment team for support.
9014Cause: When the user clicks to buy an item, the Store returns an error
Solution:
Collect userId, itemId, gameId and contact the Payment team for support.
9015Cause: Retrieve item information in inventory but not found
Solution:
- Check if the item has been declared
- Check sandbox account

VNGGames Account errors

This section details the specific error codes that can be returned by the VNGGames Account service. These errors typically indicate issues originating from the VNGGames Account service’s internal logic or its interactions with the underlying operating system or network services.

Error CodeOverview
7002Cause: User cancelled the authentication process
Solution:
- Check the keystore; you must use the keystore provided by the Store team.
- Ensure the integrity of the GTSDK.json config file; do not modify this file.