tencent cloud

Tencent Cloud Super App as a Service

Mini Game Payment

PDF
Focus Mode
Font Size
Last updated: 2025-04-29 18:40:52

Mini game payment APIs

Mini game payment callback

The callback URL can be configured in the SAS console.


Request parameters

Parameter
Type
Description
Required
Note
EventType
string
Message type.
True
Message type. For virtual item delivery, this is always: event
Event
string
Event type.
True
Event type.
For in-game direct purchase, this is always:
minigame_game_pay_goods_deliver_notify
PayModel
string
Payment method.
True
Payment method.
Payload
string
Payment payload information.
True
Detailed content in JSON format. See the Payload table below. (All message content is formatted as JSON for unified signature verification.)
PayEventSig
string
Payment signature.
True
Payment signature. For details, refer to
Payload
Parameter
Type
Description
Required
Note
OpenId
string
openid
True
The openid of the player who receives the virtual item.
Env
string
Environment configuration.
True

Environment configuration.
0: Live environment (also known as production environment)
OutTradeNo
string
Order number.
True
Order number.
GoodsInfo
Object
The virtual item for delivery.
True
The virtual item for delivery.
GoodsInfo
Parameter
Type
Description
Required
Note
ProductId
String
Game item ID.
True
Game item ID.
Quantity
Number
Quantity of game items purchased.
True
Quantity of game items purchased.
ZoneId
String
Server region ID.
True
Server region ID.
OrigPrice
Number
Original game item price (in cents).
True
Original game item price (in cents).
ActualPrice
Number
Actual paid price (in cents).
True
Actual paid price (in cents).
Attach
String
Pass-through data.
True
Pass-through data.
OrderSource
Number
1 In-game order 2 Marketplace order 3 Marketplace test order
True
1 In-game order

Response parameters

Name
Type
Required
Note
returnCode
string
True
Response code, 0 indicates success.
returnMessage
string
False
Response message.
data
string
True
Response data, OK indicates success.
requestId
string
True
Request trace ID.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback