# 保障单更新通知
# 接口说明
视频号小店会通过该接口将保障单更新的消息通知给商户。
# 注意事项
- 回调url设置和消息推送规则需参考消息推送文档 ,如果设置的回调url无法访问,商户将无法收视频号小店发送的通知;
# 请求参数说明
参数 | 类型 | 描述 |
---|---|---|
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 EcGuaranteeInfo | 事件主体,结构体详情请参考EcGuaranteeInfo |
# 请求参数示例(解密后的明文JSON)
{
"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
# 结构体
# EcGuaranteeInfo
事件主体
参数 | 类型 | 描述 |
---|---|---|
status | String | 保障单状态,参考GuaranteeStatus |
guarantee_order_id | string | 小店保障单号 |
order_id | string | 小店订单号 |
# 枚举值
# GuaranteeStatus
# 保障单状态
枚举值 | 描述 |
---|---|
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 | 用户取消申请 |