以下接口提供给小程序开发者用于接收、查询、处理小程序用户交易类投诉。小程序交易类投诉全流程如下:

交易投诉处理 - 图1

交易类投诉处理能力包括:

  1. 接收投诉信息推送

  2. 查询投诉单信息

  3. 商家回应投诉

  4. 商家补充凭证

  5. 商家提交处理凭证

投诉信息推送

如有新增投诉、投诉进展变更、投诉信息更新时,平台将把投诉信息推送到小程序开发者配置的消息服务器。查看消息服务器配置

  1. <appid>123</appid>
  2. <MsgType><![CDATA[event]]></MsgType>
  3. <Event><![CDATA[complaint_callback]]></Event>
  4. <option_type>123</option_type>
  5. <complaint_order_id>123</complaint_order_id>
  6. <status>123</status>
  7. <create_time>123</create_time>
  8. <expire_time>123</expire_time>
  9. <type>123</type>
  10. <order_id>123</order_id>
  11. <out_trade_no>123</out_trade_no>
  12. <phone_number>123</phone_number>
  13. <open_id>123</open_id>
  14. <customer_material_content>123</customer_material_content>
  15. <customer_material_media_id_list>123</customer_material_media_id_list>
  16. <pay_time>123</pay_time>
  17. <total_cost>123</total_cost>
  18. <product_name>123</product_name>
  19. <history>
  20. <time>123</time>
  21. <content>123</content>
  22. <media_id_list>123</media_id_list>
  23. </history>
  24. <history>
  25. <time>123</time>
  26. <content>123</content>
  27. <media_id_list>123<dia_id_list>
  28. </history>
字段名字段说明
appid小程序appid
事件类型
option_type通知事件类型:首次发起投诉/投诉进度更新
complaint_order_id投诉单号
status投诉单状态
create_time投诉发起时间
expire_time投诉当前状态到期时间
type投诉问题类型,枚举值如下:
//发货问题
611:未按约定时间发货
612:商家拒绝发货
613:少发/错发
614:物流信息长时间不更新
//客服问题
621:客服不回复
622:客服辱骂/骚扰/恐吓
//承诺未履行
631:赠品承诺未履行
632:物流承诺未履行
633:其他
//商品问题
641:描述不符
642:商品破损
643:其他
order_id被投诉的微信支付单号
out_trade_no商家订单号
phone_number投诉人联系方式
open_id投诉人openid
customer_material_content投诉详情-文本
customer_material_media_id_list投诉详情-图片
pay_time被投诉的订单交易时间
total_cost被投诉的订单金额
product_name被投诉的订单商品描述
history投诉进度,time 进度变更时间,content 进度变更文本,media_id_list 进度变更图片

查询投诉单详情

request: https://api.weixin.qq.com/wxaapi/minishop/complaintOrderDetail?complaintOrderId=xxx&access\_token=xxx

response:

返回结果示例

  1. {
  2. errcode: 0,
  3. errmsg: "ok",
  4. complaintOrder: {
  5. complaintOrderId: 'sadfasdf',//订单id
  6. openId: 'dfasefasefase', //openId
  7. createTime: 123124124, //投诉发起时间
  8. phoneNumber: 156222222, //联系方式
  9. type: 12, //投诉问题分类
  10. status: 1,//订单状态,枚举值
  11. customerMaterial:{
  12. content: '', //投诉内容
  13. mediaIdList: ['fsadfasdfsaf'] //投诉内容图片cdn列表
  14. },
  15. orderId: '2342', //微信支付订单号
  16. outTradeNo: 'sdfsfd', //商家订单号
  17. productName: 'sdf', //商品名称
  18. payTime: 123123', //支付时间
  19. totalCost: 1213, //交易金额
  20. expireTime: 1231231 //投诉单当前状态到期时间,0为不存在
  21. },
  22. // 投诉进度
  23. item:[{
  24. itemType: 1, //投诉节点状态
  25. time: 1233234234, //时间
  26. phoneNumber: 123123, //手机号
  27. content: '', //内容
  28. mediaIdList: ['asdfasdf'] //图片cdn列表
  29. }]
  30. }

返回参数含义

订单详情

参数说明
complaintOrderId订单id
openid用户的openid
createTime投诉发起时间
phoneNumber联系方式
type投诉问题分类,枚举值: 611—未按约定时间发货, 612—商家拒绝发货, 613—少发/错发, 614—物流信息长时间不更新,621—客服不回复, 622—客服辱骂/骚扰/恐吓, 631—赠品承诺未履行, 632—物流承诺未履行, 633—其他, 641—描述不符, 642—商品破损, 643—其他
customerMaterial.content投诉内容
customerMaterial.mediaIdList投诉内容图片cdn
orderId微信支付订单号
outTradeNo商家订单号
productName商品名称
payTime支付时间
totalCost交易金额
status投诉单状态,枚举值参考下面表格

投诉单状态枚举

说明
101平台客服处理中
103平台客服处理中
104平台客服处理中
105平台客服处理中
106待商家补充凭证
107平台客服处理中
108待双方补充凭证
109平台客服处理中
112投诉已完结
115投诉已完结
116投诉已完结
201待处理
202商家超时未回应,待用户确认
203已回应,待用户确认
204已回应,待用户确认
205投诉已完结
206平台已判定为商责,待上传处理凭证
207平台客服核实凭证中
208超时未上传凭证
209投诉已关闭

投诉进度

参数说明
itemType每个节点的类型,枚举值 参考下面表格
time时间
phoneNumber手机号
mediaIdList图片cdn资源列表

itemType合法值:

描述
1用户发起投诉
2用户补充留言
3商家补充留言
7用户补充凭证
8商家补充凭证
11用户申请平台客服协助
13平台客服处理中
14待用户补充凭证
16待商家补充凭证
18平台要求双方补充凭证
26平台核实处理凭证异常,投诉关闭,请商家自行联系用户解决问题,保障用户体验
30平台已核实此投诉非商家责任,投诉已完结
31平台已核实此投诉为商家责任,待上传处理凭证
32平台已核实此投诉为商家责任,待上传处理凭证
33平台已核实此投诉非商家责任,投诉已完结
36平台已核实处理凭证,投诉完结
37平台核实处理凭证异常,投诉关闭,请商家自行联系用户解决问题,保障用户体验
101商家超时未回应投诉
104用户认可处理结果,投诉已完结
107商家超时未提交投诉处理凭证,平台客服处理中
108用户超时未确认商家回应结果,投诉已完结
109商家已回应投诉
110商家提交投诉处理凭证

商家回应投诉

请求方法: post

https://api.weixin.qq.com/wxaapi/minishop/bussiRespondComplaint?access\_token=xxx

request参数示例:

  1. {
  2. content = "", //回应的内容
  3. complaintOrderId = "", //单号
  4. mediaIdList = [], //图片的id
  5. bussiHandle// 操作1是同意和解,2是拒绝和解
  6. }

请求参数含义:

参数类型必填说明
contentstringcontent跟mediaIdList二选一必填回应的内容(图片数组跟内容二选一必填)
complaintOrderIdnumber单号
mediaIdListArray<string>content跟mediaIdList二选一必填图片id列表,可参考这 https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html
bussiHandlenumber操作:1是同意和解,2是拒绝和解

返回示例

  1. {
  2. "errcode": 0 // 0:成功
  3. }

商家补充凭证

请求方法: post

https://api.weixin.qq.com/wxaapi/minishop/bussiSupplyProof?access\_token=xxx

request参数示例:

  1. {
  2. content = "",
  3. complaintOrderId = "", //单号
  4. mediaIdList = [], // 图片的idlist
  5. }
参数类型必填说明
contentstringcontent跟mediaIdList二选一必填回应的内容(图片数组跟内容二选一必填)
complaintOrderIdnumber单号
mediaIdListArray<string>content跟mediaIdList二选一图片id列表,可参考这 https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html

正确返回示例

  1. {
  2. "errcode": 0 // 0:成功
  3. }

商家提交退款凭证

请求方法 post

https://api.weixin.qq.com/wxaapi/minishop/bussiSupplyRefund?access\_token=xxx

request参数示例:

  1. {
  2. content = "",
  3. complaintOrderId = "", //单号
  4. mediaIdList = [], // 图片的idlist
  5. }
参数类型必填说明
contentstringcontent跟mediaIdList二选一必填回应的内容(图片数组跟内容二选一必填)
complaintOrderIdnumber单号
mediaIdListArray<string>content跟mediaIdList二选一必填图片的id list 图片id列表,可参考这 https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html

正确返回示例

  1. {
  2. "errcode": 0 // 0:成功
  3. }