| 项目 | 说明 |
|---|---|
| 请求方法 | POST |
| Content-Type | application/json |
| 连接超时 | 15 秒 |
| 读取超时 | 15 秒 |
| 成功应答 | 响应 body 返回纯文本 success(不含引号、不含换行) |
| 失败判定 | HTTP 非 2xx、超时、或响应 body ≠ success |
| 重试次数 | 间隔 |
|---|---|
| 第 1 次 | 15 秒 |
| 第 2 次 | 30 秒 |
| 第 3 次 | 1 分钟 |
| 第 4 次 | 5 分钟 |
| 第 5 次 | 10 分钟 |
{
"event": "order.created",
"timestamp": 1722412800,
"nonce_str": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"data": {
"out_order_id": 5001,
"out_order_no": "OO202507310001",
"status": 0,
"status_text": "待派单",
"game_name": "原神",
"total_quantity": "100.0000",
"currency": "USD",
"total_amount": "5000.00",
"base_currency": "USD",
"base_total_amount": "5000.00"
},
"sign": "A3F8B2C1D4E5F60718293A4B5C6D7E8F"
}| 字段 | 类型 | 说明 |
|---|---|---|
| event | string | 事件类型标识(见第六节) |
| timestamp | int | Unix 时间戳(秒) |
| nonce_str | string | 32 位随机字符串,防重放 |
| data | object | 业务数据,各事件不同(见第七节) |
| sign | string | 签名值,MD5 大写(见第五节) |
✅ 回调验签与 OpenAPI 请求签名是同一套算法(服务端统一实现,GameSCM SOMS → 你 与 你 → GameSCM SOMS 共用),
拼串规则详见 第十六节「OpenAPI 请求签名详解」。参考实现:doc/open-api-sdk-php.php
(请求签名Signer与回调验签NotificationVerifier共用同一签名核心Signature,零依赖,php doc/open-api-sdk-php.php --test可跑通官方回调样例自测)。⚠️ 历史兼容:2026-09-21 之前发出的回调按旧算法(data 整体 JSON 字符串参与签名)生成 sign,与本节算法不兼容;对接方升级到本节算法后,历史消息重推即可对上。
sign),过滤空值(空字符串、null,仅顶层生效)key1=value1&key2=value2&...(data 展平为 data[字段]=值 形式,不是整体 JSON 字符串)&key={AppSecret}strtoupper(md5(...)){
"event": "order.created",
"timestamp": 1722412800,
"nonce_str": "abc123",
"data": { "out_order_no": "OO001", "status": 0 },
"sign": "..."
}// 1. 移除 sign,递归字典序排序后展平(data 展开为 data[key]=value)
stringA = "data[out_order_no]=OO001&data[status]=0&event=order.created&nonce_str=abc123×tamp=1722412800"
// 2. 追加 secret
stringSignTemp = stringA + "&key=your_app_secret"
// 3. 签名
sign = strtoupper(md5(stringSignTemp))FSOMS_APP_SECRET 换成你的 AppSecret 即可复现):{
"data": {
"status": 5,
"status_text": "已完成",
"out_order_no": "D260921134255174302-01",
"raw_order_no": "D260921134255174302"
},
"sign": "BC91C0339A4DF0C48648AF7EB0DFC929",
"event": "order.completed",
"nonce_str": "2d8b1c973fc135510728d77f9c4ea81f",
"timestamp": 1789970543
}doc/open-api-sdk-php.php 中的 NotificationVerifier(与请求签名 Signer 共用同一签名核心 Signature,零依赖,php doc/open-api-sdk-php.php --test 可跑通上述官方样例)。核心逻辑: