Mini Game Virtual Payment (Proxy mode)
Last updated: 2025-09-23 16:48:49
Mini Game Virtual Payment (Proxy mode)
Last updated: 2025-09-23 16:48:49
Overview
After the team has bound the merchant, if the mini game within the team needs to use virtual payment, the mini program team administrator needs to apply to the superapp under the "Commercialization - Virtual Payment" module to activate the payment function for the mini game. Only after receiving approval from the superapp can the mini program access its payment capabilities.
Note:
1. Virtual payment currently only supports direct in-game item purchases and is exclusively available for mini games.
2. 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.
Functional modules and operation procedures
1. Enable payment
1.1. Process
1. Select the mini game for which you want to enable the payment function and click Request permission.
2. Enter the request message, click Confirm, submit the application, and wait for the superapp approval.
3. After approval, a virtual account and AppKey will be generated. The virtual account will be used when calling virtual payment related APIs. It is mainly used to associate the merchant of the superapp. The AppKey is used for paySign of mini game payment orders and calculation of signatures for callback content pay_event_sig.
1.2 Security
After enabling payment, SAS will generate a security certificate for identity verification during the virtual payment process of the mini game. Please keep it properly after downloading. If there is a risk of the certificate being leaked, please reset it in a timely manner. Only the mini program team administrators and mini program senior developers can download and reset certificates.
2. Basic Configuration
2.1 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 Configuration, enter the delivery notification domain name, and apply to the superapp for the certificate and key for interface security verification.
Parameter description:
URL: The API URL that developers use to receive item delivery notifications. The URL filled in by the developer must start with http:// or https://, and supports ports 80 and 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.
2.2 No-review permission for virtual items
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.
3. Virtual Item Management
3.1 Add virtual item
In Virtual payment-Virtual item management, developers can Add virtual items, create game items.
When adding the item, you need to fill in the item information. The required information is:
Item ID: supports 32 English characters, numbers and underscores.
Item name: within 20 characters, spaces are supported.
Item price: supports 2 decimal places, with an upper limit of no more than 100,000,000. Please pay attention to the payment currencies supported by SuperApp.
Item images: Support jpg/png, 200x200, no more than 200 KB.
Non-mandatory information includes:
Note: within 50 characters
3.2 Add virtual items in batches
You can also download the import template, fill in the Excel form, and then click Import virtual items to import game items in batches.
3.3 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.
4. Order Record
When a mini game player in the superapp purchases items in the mini game and completes the payment, he or she can check the mini game items direct purchase order in Virtual Payment-Order Record.
5. After-Sales Records
Superapp users can initiate a refund for virtual payment orders. After the refund slip is generated, it can be found in Commercialization - Virtual payment- After-sales records. Order data can be queried by the refund request time (default: last 7 days), with a maximum time range of last 12 months. Refund orders can be searched by order number/refund number. Exporting detailed data is supported.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback