#
Description
- Order Status Batch Change Notification
Request Method
- HTTPS
- POST
- Parameters are in JSON format and placed in the body
Request Parameters (Additional fields may be added, please ensure compatibility with the new fields on the server side)
| Parameter Name |
Required |
Type |
Description |
Example |
| notify_id |
Yes |
string |
Notification ID |
0795d77f85789da0eb387a5096 |
| notify_time |
Yes |
string |
Timestamp (in milliseconds) on the server when the notification is sent |
1647834452408 |
| app_id |
Yes |
string |
Application ID of the message recipient |
1 |
| notify_event |
Yes |
string |
Notification event |
sud.mg.merchant.order.batch.changed |
| data |
Yes |
OrderBatchChangedModel |
Notification data |
{} |
OrderBatchChangedModel
| Parameter Name |
Required |
Type |
Description |
Example |
| mg_id |
Yes |
string |
Game ID |
14615640800525066 |
| room_id |
Yes |
string |
Room ID |
9009 |
| orders |
Yes |
OrderBatchChangedEntry[] |
Array of order data |
[] |
OrderBatchChangedEntry
| Parameter Name |
Required |
Type |
Description |
Example |
| order_id |
Yes |
string |
SUD order number |
1659497694888 |
| out_order_id |
Yes |
string |
Merchant-defined unique order number |
1659497694000 |
| game_round_id |
No |
string |
Game round ID associated with the order |
ce56b6lzi1a7 |
| cmd |
Yes |
string |
Triggered action |
test |
| from_uid |
Yes |
string |
UID of the paying user |
u001 |
| to_uid |
Yes |
string |
UID of the target user |
u002 |
| value |
Yes |
int32 |
Associated game value |
1 |
| payload |
No |
object |
Additional data |
|
| status |
Yes |
string |
Order status:
EXECUTE_FAIL (execution failed), EXECUTE_SUCCESS (execution successful) |
EXECUTE_SUCCESS |
Message Signature Verification
Signature Verification
Request Example
{
"notify_id": "xxx",
"notify_time": "1765939618445",
"app_id": "xxx",
"notify_event": "sud.mg.merchant.order.batch.changed",
"data": {
"mg_id": "xxx",
"room_id": "xxx",
"orders": [
{
"order_id": "xxx",
"out_order_id": "xxx",
"game_round_id": "xxx",
"cmd": "gift_cover_big_chain",
"value": 1,
"from_uid": "15493",
"to_uid": "15444",
"status": "EXECUTE_FAIL"
}
]
}
}
Notification Response
| Parameter Name |
Required |
Type |
Description |
Example |
| ret_code |
Yes |
int32 |
Return status code. 0 indicates successful message notification, other error codes indicate failure |
0 |
| ret_msg |
Yes |
string |
Return message |
SUCCESS |
Response Example
{
"ret_code": 0,
"ret_msg": "SUCCESS"
}