小程序无忧退货(运费险)是微信官方推出的售后退换货保障服务。商家向微信充值保费后,可以为用户订单购买运费险,若订单发生退换货,无忧退货支持用户预约上门取件,寄退货免付基础运费,最高抵扣¥19.35(基本全国免费寄退货)。商家使用无忧退货无需支付额外费用。
- 预充值:商家通过微信向保司充值保费,账期60天,到期未用余额自动原路退回。
- 投保:商家需要对订单投保时,通过投保接口向微信主动发起投保。
- 理赔:
- 上门取件:京东上门取件,用户寄件时直接抵扣基础运费,最高抵扣¥19.35。
- 自行寄回:支持全部物流公司,用户自行线下寄回后填写退货物流单号,理赔款¥10打款到用户微信零钱包。
- 退款:商家主动向微信/系统自动发起退款,资金原路返回。
注:微信支付单号、保单号、理赔单号一一对应,一笔交易订单仅能投保和理赔一次。
小程序后台-功能-物流服务-无忧退货(运费险)
目前支持开具电子普票、纸质普票和纸质增值税专用发票,商家可以在指定日期,按照要求邮件申请(附件大小不超过15M),开具的纸质发票将通过快递的方式寄送给商家,发票邮寄费用由商家自行承担。电子发票由所填邮箱接收。
邮件标题:运费险发票申请-xx小程序x月
邮件正文及附件内容:
小程序主体名、小程序appid、开票金额(元)、纳税人名称(与小程序主体一致)、纳税人识别号、地址、电话、开户行及账号、电子邮箱、联系人及电话
营业执照扫描件/复印件,加盖公章
需要开票的保单信息(可在小程序后台-物流服务-无忧退货-保单信息中筛选下载excel)
发送时间:请在每月初1-5日,发送邮件申请。
开票邮箱: xuziyi900@pingan.com.cn
https://api.weixin.qq.com{PathName}?access_token=${access_token}
文档所有接口请求方式均为HTTPS-POST请求,UTF-8编码,请求和相应参数仅支持JSON数据格式,所有接口的调用均需要获取access_token授权,服务商获取access_token,走微信开放平台-第三方平台的模式。 调用主体为小程序appid 或 第三方平台appid均可,二选一即可。
PathName: /wxa/business/insurance_freight/open 请求参数: 无 返回参数: 无
PathName: /wxa/business/insurance_freight/query_open 请求参数: 无 返回参数:
PathName: /wxa/business/insurance_freight/createorder 请求参数:
返回参数:
请求参数示例
返回参数示例
PathName: /wxa/business/insurance_freight/claim 请求参数:
返回参数:
请求参数示例
返回参数示例
接入方式
如果需要监听理赔结果的事件,接入方式可以参考公众平台的消息推送:
如果开发者是小程序商家,请移步 消息推送
如果开发者是服务商第三方平台,请移步 消息与事件接收配置
理赔结果推送事件
事件类型: wxainsurance_claim_result
参数
参数示例
PathName: /wxa/business/insurance_freight/createchargeid 请求参数:
返回参数:
请求参数示例
返回参数示例
PathName: /wxa/business/insurance_freight/applypay 请求参数:
返回参数:
特别提示: 充值后退款只能退回原充值账号
请求参数示例
返回参数示例
PathName: /wxa/business/insurance_freight/getpayorderlist 请求参数:
返回参数:
请求参数示例
返回参数示例
PathName: /wxa/business/insurance_freight/refund 请求参数: 无 返回参数: 无 特别提示: 充值后退款只能退回原充值账号
PathName: /wxa/business/insurance_freight/getsummary 请求参数:
返回参数:
PathName: /wxa/business/insurance_freight/getorderlist 请求参数:
返回参数:
请求参数示例
返回参数示例
开发者可通过接口自定义余额为xx时通知小程序管理员(余额xx无改动情况下24h内通知一次)。通知消息将通过 微信公众平台 下发。
PathName: /wxa/business/insurance_freight/update_notify_funds 请求参数:
返回参数: 无
- 描述:商家在同意用户退货之后,通过本接口创建退货ID,shop_order_id和退货 ID 一一对应。一个订单需要多次退货”的场景,可以在商家内部 1 个退货订单号映射多个shop_order_id。注:该接口中文相关的字段用UTF-8。
- 提醒退货通知:商家创建退货 ID 时,平台会自动下发模板消息给用户,提醒用户退货。
- 请求地址:https://api.weixin.qq.com/cgi-bin/express/delivery/no_worry_return/add?access_token=ACCESS_TOKEN
- 请求方式:POST
- 请求参数
- 返回参数
- 错误码列表
- 描述:本接口用于商家查询用户退货状态(是否填写退货信息)及追踪用户退货物流,方便仓库收货。通过本接口查询退货 ID 状态,其中status是退货ID状态,order_status是退货 ID 对应的用户运单号的状态。
- 请求地址:https://api.weixin.qq.com/cgi-bin/express/delivery/no_worry_return/get?access_token=ACCESS_TOKEN
- 请求方式:POST
- 请求参数
- 返回参数
- 错误码列表
- 描述:当商家同意退货申请之后,与用户达成协商「无需退货」时,可以通过本接口可以解除商家退货单与退货 ID的绑定。考虑到预约快递员上门取件的情况在用户侧发生,因此只有当用户是自主填写运单号情况下才支持解绑退货 ID 。
- 请求地址:https://api.weixin.qq.com/cgi-bin/express/delivery/no_worry_return/unbind?access_token=ACCESS_TOKEN
- 请求方式:POST
- 请求参数
- 返回参数
- 错误码列表
商家可选择调用组件(the latest version)至小程序页面,实现用户在小程序页面内点击按钮拉起退货寄件。
①订单有运费险:拉起无忧退货页面,上门取件抵扣基础运费。
②订单无运费险:拉起半屏弹窗,上门取件自付运费。
基本用法
test.wxml:
test.js:
test.json: