# 保障单更新通知
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
事件英文名:channels_ec_guarantee_update
微信小店会通过该接口将保障单更新的消息通知给商户。
相关 API 接口:
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小店UserName |
| FromUserName | string | 固定的OpenID |
| CreateTime | number | 事件时间,Unix时间戳,即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数 |
| MsgType | string | 消息类型,固定为event |
| Event | string | 事件类型,本接口固定为channels_ec_guarantee_update |
| finder_shop_guarantee_status_update | object | 事件主体 |
# Body.finder_shop_guarantee_status_update Object Payload
事件主体
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| status | string | 保障单状态 | 枚举值 |
| guarantee_order_id | string | 小店保障单号 | - |
| order_id | string | 小店订单号 | - |
# 2. 消息返回
# 返回体 Response Payload
回复 success 或空字符串(无需加密)
# 3. 枚举信息
# Body.finder_shop_guarantee_status_update.status Enum
保障单状态
| 枚举值 | 描述 |
|---|---|
| STATUS_WAIT_MERCHANT_HANDLE | 等待商家处理 |
| STATUS_WAIT_PLATFORM_HANDLE | 等待平台处理 |
| STATUS_WAIT_USER_CONFIRM | 等待用户确认 |
| STATUS_WAIT_MERCHANT_PROOF | 等待商家举证 |
| STATUS_WAIT_USER_PROOF | 等待用户举证 |
| STATUS_WAIT_BOTH_PROOF | 等待双方举证 |
| STATUS_WAIT_OP_COMFIRM | 等待OP确认 |
| STATUS_WAIT_PAYSCORE_DONE | 等待支付分付款 |
| STATUS_NO_NEED_PAY | 无需赔付 |
| STATUS_PAYING | 赔付中 |
| STATUS_PAY_BLOCK | 假一赔四金额异常,待确认 |
| STATUS_PAY_SUCC | 赔付成功 |
| STATUS_PAY_FAIL | 赔付失败 |
| STATUS_USER_CANCEL | 用户取消申请 |
# 4. 注意事项
- 回调url设置和消息推送规则需参考消息推送文档 ,如果设置的回调url无法访问,商户将无法收视频号小店发送的通知;
# 5. 代码示例
请求示例
{
"ToUserName": "gh_*",
"FromUserName": "OpenID",
"CreateTime": 1662480000,
"MsgType": "event",
"Event": "channels_ec_guarantee_update",
"finder_shop_guarantee_status_update": {
"status": "STATUS_PAY_SUCC",
"guarantee_order_id": "1234567",
"order_id":"12345"
}
}
返回示例
success