# 保障单更新通知

本文档描述服务器端接收的消息或事件,详细说明参见消息推送

事件英文名:channels_ec_guarantee_update

微信小店会通过该接口将保障单更新的消息通知给商户。

相关 API 接口:

# 1. 消息参数

# 请求体 Request Payload

参数名类型说明
ToUserNamestring小店UserName
FromUserNamestring固定的OpenID
CreateTimenumber事件时间,Unix时间戳,即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数
MsgTypestring消息类型,固定为event
Eventstring事件类型,本接口固定为channels_ec_guarantee_update
finder_shop_guarantee_status_updateobject事件主体

# Body.finder_shop_guarantee_status_update Object Payload

事件主体

参数名类型说明枚举
statusstring保障单状态枚举值
guarantee_order_idstring小店保障单号-
order_idstring小店订单号-

# 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