tencent cloud

All product documents
Tencent Cloud Super App as a Service
Direct Purchase of Mini Game Items
Last updated: 2025-04-03 18:17:28
Direct Purchase of Mini Game Items
Last updated: 2025-04-03 18:17:28

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

1.Operation page

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.


3.Basic configuration

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.


5.Order record

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.


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon