67 lines
2.1 KiB
Markdown
67 lines
2.1 KiB
Markdown
订单异步通知
|
||
创建订单时可传入 notify_url。当该订单充值状态发生变化时，平台将向该地址 POST JSON 通知（队列异步发送，失败自动重试）。
|
||
|
||
#触发时机
|
||
下单成功创建订单后（首次状态，如 15 待绑定）
|
||
之后每次 recharge_status 变更（如 17 已提交、30 成功、40 失败等）
|
||
仅 开放 API 订单（platform=api）且下单时传了有效 notify_url 才会推送。
|
||
|
||
#商户接收要求
|
||
项目 说明
|
||
方法 POST
|
||
Content-Type application/json
|
||
成功响应 HTTP 2xx（建议返回 {"code":0} 或纯文本 OK）
|
||
超时 平台默认 10 秒，超时或 5xx 将按队列重试（默认最多 5 次）
|
||
#签名
|
||
Header：
|
||
|
||
Header 说明
|
||
X-App-Key 您的 App Key
|
||
X-Timestamp Unix 秒级时间戳
|
||
X-Sign HMAC_SHA256(app_key + timestamp + raw_json_body, app_secret) 小写 hex
|
||
验签时使用与请求开放 API 完全相同的原始 Body 字符串，勿重新格式化 JSON。
|
||
|
||
#通知 Body 结构
|
||
json
|
||
{
|
||
"event": "order.status_changed",
|
||
"order": {
|
||
"order_no": "202601011200001234",
|
||
"platform_order_no": "YOUR-ORDER-001",
|
||
"platform": "api",
|
||
"product_code": "10000001",
|
||
"product_name": "和平精英点券",
|
||
"recharge_status": 30,
|
||
"recharge_status_label": "充值成功",
|
||
"status": 30,
|
||
"status_label": "充值成功",
|
||
"points_charged": 3800,
|
||
"player_account": "123456789",
|
||
"notify_url": "https://your-server.com/open-api/order-notify",
|
||
"recharge_finish_at": "2026-01-01 12:30:00",
|
||
"updated_at": "2026-01-01 12:30:00"
|
||
}
|
||
}
|
||
order 字段与「查询订单」接口结构基本一致（通知中不含 h5 链接；含 product_code）。
|
||
|
||
#PHP 验签示例
|
||
php
|
||
$rawBody = file_get_contents('php://input');
|
||
$appKey = $_SERVER['HTTP_X_APP_KEY'] ?? '';
|
||
$timestamp = $_SERVER['HTTP_X_TIMESTAMP'] ?? '';
|
||
$sign = $_SERVER['HTTP_X_SIGN'] ?? '';
|
||
$appSecret = 'your_app_secret';
|
||
|
||
$expected = hash_hmac('sha256', $appKey . $timestamp . $rawBody, $appSecret);
|
||
if (!hash_equals($expected, $sign)) {
|
||
http_response_code(401);
|
||
exit('invalid sign');
|
||
}
|
||
|
||
$data = json_decode($rawBody, true);
|
||
// 处理 $data['order'] ...
|
||
|
||
http_response_code(200);
|
||
echo json_encode(['code' => 0]);
|
||
|