微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 订单其他信息更新

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

    事件英文名：channels_ec_order_ext_info_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_order_ext_info_update
    order_infoobject事件主体

    # Body.order_info Object Payload

    事件主体

    参数名类型说明
    order_idnumber订单号
    typenumber1：联盟佣金信息 2：商家主动地址修改或通过用户修改地址申请 3：商家备注修改 4：用户发起申请修改收货地址，特殊条件下需要商家审批 5：订单虚拟号码信息更新 6：分享员信息更新 7：用户催发货 8：商家修改礼物单备注 9：用户发起发货前更换sku请求 10：商家同意用户发货前更换sku请求 11：用户收礼时更换sku 12：商家修改订单价格 13：真实号审核结果 14：分配代发 15：取消代发 16：买家已同意修改，请按新地址发货 17：买家已拒绝修改，请按原地址发货 18：买家超时未确认，修改申请已失效 19：买家已主动修改地址，请按新地址发货 20：该订单已发货，修改申请已失效

    # 2. 消息返回

    # 返回体 Response Payload

    回复 success 或空字符串（无需加密）

    # 3. 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收微信小店发送的通知；

    • 重试规则：如果接收方未能响应http请求（最长等待5秒），会认为推送失败，并以一定策略重试推送。重试策略为0s/0s/10s/1min/5min/30min/60min/60min/60min，最多推送10次，总计约3.6h。

    # 4. 代码示例

    请求示例

    {
    "ToUserName": "gh_*", 
    "FromUserName": "OPENID", 
    "CreateTime": 1662480000, 
    "MsgType": "event", 
    "Event": "channels_ec_order_ext_info_update", 
    "order_info": {
        "order_id": 3705115058471208928, 
        "type": 1
    }
}

    返回示例

    success
    文档变更日志（2条）
    2025 年 12 月 23 日
    type 字段新增「买家已同意修改，请按新地址发货」等 6 个枚举类型
    2025 年 12 月 15 日
    增加订单更新事件