电商商家事件通知推送
事件通知是由微博电商平台通知接入的商家，目前主要为订单事件通知，仅限虚拟商家接入。
接入流程
接入的商家需要根据自身业务的情况，维护自己的订单状态服务器。
1、开发事件通知接收请求地址
接入的自研商家，需要先开发一个用来接收事件通知的请求地址，当有事件通知时，微博电商平台将调用这个请求地址，将事件通知发送给接入的商家。
请求方式
POST
内容类型
Content-Type 为 application/x-www-form-urlencoded
请求参数
| 参数名称 | 是否必填 | 类型 | 说明描述 |
|---|---|---|---|
| sign | true | string | 验证签名，签名算法见 电商接口验证签名。 |
| type | true | int | 业务类型，2 - 子订单。 |
| time | true | int | 10位秒级时间戳。 |
| data | true | string | 通知内容，为JSON字符串，通过 type 判断业务类型，不同业务类型数据格式不同，具体字段见下面的 通知内容 说明。 |
通知内容
子订单事件，type = 2
{
"recharge_account_type": "3",
"recharge_account": "1234567890",
"sub_order_id": "366383890000352",
"state_code": 202,
"addtime": "2022-07-21 12:15:02",
"pay_time": "1970-01-01 00:00:00",
"buyer_id": "1766",
"sku_list": [
{
"goods_id": "1083814100038",
"sku_id": "3924",
"state_code": 502,
"sold_state_code": 601,
"pin": ""
}
],
"buyer": {
"weibo_uid": "6748678500"
}
}
| 推送字段 | 类型 | 字段说明描述 |
|---|---|---|
| recharge_account_type | int | 充值账号类型，1 - 手机号码，2 - QQ账号，3 - 微信昵称。 |
| recharge_account | string | 充值账号。 |
| sub_order_id | int64 | 子订单ID。 |
| state_code | int | 订单状态码，详见 电商服务商开发编码索引。 |
| addtime | date time | 创建时间。 |
| pay_time | date time | 支付时间。 |
| buyer_id | int | 买家ID。 |
| sku_list | object array | 子订单商品信息列表。 |
| goods_id | int64 | SPU ID。 |
| sku_id | int | SKU ID。 |
| state_code | int | SKU正向状态码。 |
| sold_state_code | int | SKU逆向状态码。 |
| pin | int | PIN码。 |
| buyer | object | 买家信息。 |
| weibo_uid | string | 买家微博UID。 |
请求响应
接入的商家收到事件通知后，需要按如下JSON格式返回相应
{
"code": 0,
"msg": "",
"data": {}
}
| 返回字段 | 类型 | 字段说明描述 |
|---|---|---|
| code | int | 必需返回，返回状态码，0-正常，其他为异常。 |
| msg | string | 可选是否返回，返回的错误提示。 |
| data | json object | 可选是否返回，返回的错误数据。 |
2、设置事件通知接收请求地址
注意事项
当前支持的通知事件：订单已支付、订单已关闭
不保证消息顺序。
不保证中间态消息不丢失（仅保证终态消息不丢失）。
接口性能必需在200ms内，超时将按照补偿策略通知（补偿通知不保证时效）。
接口需要保证幂等（可能发起重复通知）。
首次通知会在2分钟内送达（99.99%的通知会在1分钟内送达）。
首次通知超时、失败，则会进行补偿通知。补偿通知最多11次，每次延时（2的N次方）分钟。
业务方需要根据自身业务处理相关异常。
文档更新时间: 2023-02-06
