#
Description
- Order Status 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.changed |
| data | Yes | OrderChangedModel | Notification data | {} |
OrderChangedModel
| 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 |
| out_group_id | No | string | Merchant-defined order group ID | 1659497694 |
| mg_id | Yes | string | Game ID | 14615640800525066 |
| room_id | Yes | string | Room ID | 9009 |
| 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 | No | int32 | Game value to which the order belongs | 1 |
| seq | No | int32 | Sequence number (default: 0) used when there are timing requirements in the game | 0 |
| payload | Special Optional | object | Additional data | |
| status | Yes | string | Order status: EXECUTE_FAIL (execution failed), EXECUTE_SUCCESS (execution successful) |
EXECUTE_SUCCESS |
Message Signature Verification
Request Example
{
"notify_id": "0795d77f85789da0eb387a50964993a3eba1fedfec2b12f729861392a9b5ad04",
"notify_time": "1647844976502",
"app_id": "14615640800525066",
"notify_event": "sud.mg.merchant.order.changed",
"data": {
"order_id": "1659497694888",
"out_order_id": "1659497694000",
"out_group_id": "1659497694",
"mg_id": "mgid01"
"room_id": "9009",
"game_round_id": "ce56b6lzi1a7-cqhcr6fgdnwg-c5vfwwj9h6mz",
"cmd": "test",
"from_uid": "001",
"to_uid": "002"
"value": 1,
"seq": 0,
"payload": {
"score": 1
}
"status": "EXECUTE_SUCCESS"
}
}
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",
}