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

    • # 获取保障单详情

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：getguaranteeorder

    通过该接口可以在微信小店售后管理中获取保障单详情

    相关事件通知：保障单更新通知

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/aftersale/getguaranteeorder?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：131

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填示例说明
    guarantee_order_idnumber是2000001077270153保障单号

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    guarantee_orderobject保障单详情

    # Res.guarantee_order Object Payload

    保障单详情

    参数名类型说明
    guarantee_order_idnumber保障单号
    typenumber保障单类型 1-假一赔四 2-坏损包退
    order_idnumber订单号
    statusstring保障单当前状态，参考下文
    create_timetimestamp保障单创建时间戳
    update_timetimestamp保障单更新时间戳
    apply_reasonstring申请原因
    product_infoobjarray商品信息
    expire_timenumber保障单过期时间
    openidstring买家身份标识
    unionidstring买家在开放平台的唯一标识符，若当前微信小店已绑定到微信开放平台账号下会返回，详见[UnionID 机制说明](https://developers.weixin.qq.com/doc/oplatform/open/intro.html)
    pay_amountnumber退款金额（分）
    merchant_refuse_reasonstring商家拒绝原因
    order_pay_infoobject订单支付信息
    complete_timenumber保障单完成时间
    apply_reason_typenumber申请原因
    order_present_infoobject送礼信息
    order_typenumber发起保障的订单类型；0-普通订单，10-礼物订单
    fake_one_pay_four_infoobject假一赔四保障单详情
    bad_pay_infoobject坏损包退保障单详情
    wxa_vip_discounted_pricenumber小程序会员已经优惠金额，单位分
    history_listarray协商历史

    # Res.guarantee_order.product_info(Array) Object Payload

    商品信息

    参数名类型说明
    thumb_imgstring商品小图
    titlestring商品名称
    real_pricenumber商品价格
    product_cntnumber商品件数
    detailstring商品详情

    # Res.guarantee_order.order_pay_info Object Payload

    订单支付信息

    参数名类型说明
    transaction_idstring交易单号

    # Res.guarantee_order.order_present_info Object Payload

    送礼信息

    参数名类型说明
    present_order_idnumber礼物单号
    accept_present_timenumber收礼时间
    giver_nicknamestring送礼者微信昵称

    # Res.guarantee_order.fake_one_pay_four_info Object Payload

    假一赔四保障单详情

    参数名类型说明
    identify_feenumber鉴定费用
    product_feenumber商品费用
    total_pay_feenumber预计赔付
    identify_proof_pic_listarray鉴定凭证media_id列表,根据mediaid获取文件内容接口
    fee_proof_pic_listarray费用凭证media_id列表,根据mediaid获取文件内容接口
    apply_reasonnumber申请原因，1-假一赔四假冒注册商标，2-假一赔四假冒材质成分
    acctual_paynumber最终赔付金额

    # Res.guarantee_order.bad_pay_info Object Payload

    坏损包退保障单详情

    参数名类型说明
    bad_levelnumber损坏程度
    contentstring损坏凭证文字
    pic_listarray损坏凭证图片media_id列表,根据mediaid获取文件内容接口
    pay_feenumber赔付金额，含运费
    merchant_modify_levelnumber商家协商损坏程度
    merchant_remarkstring商家备注
    platform_modify_levelnumber平台调整损坏程度
    refund_typenumber退款类型，1-仅退款，2-退货退款，3-换货
    receive_productnumber是否收到货，1-未收到货，2-收到货
    refund_reasonnumber退款原因
    refund_reason_textstring退款原因文案
    title_pic_listarray凭证图片media_id列表,根据mediaid获取文件内容接口

    # 4. 注意事项

    保障单当前状态

    枚举值 描述
    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 用户取消申请

    # 5. 代码示例

    请求示例

    {
    "guarantee_order_id": 2000001077270153
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "guarantee_order": {
        "guarantee_order_id": 0,
        "type": 0,
        "order_id": 0,
        "status": "",
        "create_time": 1750000000000,
        "update_time": 1750000000000,
        "apply_reason": "",
        "product_info": {
            "thumb_img": "",
            "title": "",
            "real_price": 0,
            "product_cnt": 0,
            "detail": ""
        },
        "expire_time": 0,
        "openid": "",
        "unionid": "",
        "pay_amount": 0,
        "merchant_refuse_reason": "",
        "order_pay_info": {
            "transaction_id": ""
        },
        "complete_time": 0,
        "apply_reason_type": 0,
        "order_present_info": {
            "present_order_id": 0,
            "accept_present_time": 0,
            "giver_nickname": ""
        },
        "order_type": 0,
        "fake_one_pay_four_info": {
            "identify_fee": 0,
            "product_fee": 0,
            "total_pay_fee": 0,
            "identify_proof_pic_list": [
                ""
            ],
            "fee_proof_pic_list": [
                ""
            ],
            "apply_reason": 0,
            "acctual_pay": 0
        },
        "bad_pay_info": {
            "bad_level": 0,
            "content": "",
            "pic_list": [
                ""
            ],
            "pay_fee": 0,
            "merchant_modify_level": 0,
            "merchant_remark": "",
            "platform_modify_level": 0,
            "refund_type": 0,
            "receive_product": 0,
            "refund_reason": 0,
            "refund_reason_text": "",
            "title_pic_list": [
                ""
            ]
        },
        "wxa_vip_discounted_price": 0
    }
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    9700223系统失败
    9700224参数错误
    10021041当前售后单不支持此操作，请检查售后单状态
    10021057售后单不存在

    # 7. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。