Introduction
Direct purchase of mini game items refers to a virtual payment method in mini games where players can directly purchase in-game virtual items (such as skins, coins, equipment, etc.) using the superapp's payment feature.
Note:
Virtual payment currently only supports direct in-game item purchases and is exclusively available for mini games.
Operation process in the console
Prerequisites
Before using the virtual payment capabilities, you need to ensure the following:
1. You have activated a merchant account in the superapp and obtained a merchant ID.
2. The payment capabilities are supported in the superapp, and the payment feature is enabled in Application management.
Note:
The merchant account (actual name as provided by the superapp) is a system provided by the superapp for mini program merchants to handle transactions, fund settlements, and account management. When a mini program (merchant) integrates with the superapp's payment system, a merchant account must be activated. The merchant ID is the unique identifier code obtained after activating the merchant account.
Process
Developers can perform operations such as merchant account binding and game item management in the console under Commercialization - Virtual payment.
2.Bind a merchant account
Navigate to Commercialization - Virtual payment - Bind merchant account , click Request to bind , enter the Merchant ID , and click Submit . The request will be approved by the superapp.
Note:
The merchant account refers to the merchant or payment account you activated within the superapp's payment system. The merchant ID is the unique identifier you obtain from the payment system.
You can check the approval status in the Approval history.
Once approved, the virtual payment feature is available and you still need to refer to the process below for item delivery notification configuration and item adding.
Delivery notification configuration
Developers need to complete the item delivery notification configuration in Virtual payment - Basic configuration to receive notifications of game item delivery.
Click Configure, and enter the URLs. When you click Save for the first time, you will request a certificate and key from the superapp for API security verification.
Parameter description:
URL: The API URL that developers use to receive item delivery notifications. The URL must start with http:// or https://, which supports port 80 and port 443 respectively.
Test URL: A URL for developers to test delivery notifications.
Request certificate and key: The first save will request a certificate and key from the superapp, which will be emailed to the account's linked email.
After the delivery notification configuration is completed, enable notification on the Virtual item management page.
Request game item no-review permissions
Game items need to be approved by the superapp before they can be released for use. Developers can request game item no-review permissions from the superapp admin. Once the request is approved, the game items can be released without the approval of the superapp.
Note:
Developers need to confirm that game items comply with the superapp's operating specifications. The superapp can disable the no-review permissions and remove the game items if necessary.
4.Virtual item management
Add virtual items
Developers can add virtual items in Virtual payment - Virtual item management.
Enter the virtual item ID, name, price, and image, and click Save.
Batch adding
You can also download the import template, fill out the Excel form, and click Import virtual items to import the game items in batch.
Virtual item release
Once game items are created, they can be released either individually or in batch. After being released, the information of the game items can be used when the developer calls the virtual payment API.
When a player purchases a game item in a mini game and completes the payment, the game item purchase order can be checked in Virtual payment - Order record.