cn.binarywang.wx.miniapp.api

接口 WxMaComplaintService

所有已知实现类:

WxMaComplaintServiceImpl

public interface WxMaComplaintService

小程序交易投诉接口

作者:

Binary Wang created on 2025-01-01

方法概要

限定符和类型	方法和说明
WxMaComplaintNotifyUrlResult	addComplaintNotifyUrl(WxMaComplaintNotifyUrlRequest request) 创建投诉通知回调地址API 商户通过调用此接口创建投诉通知回调URL，当用户产生新投诉且投诉状态已变更时，微信会通过回调URL通知商户。
void	complete(WxMaCompleteRequest request) 反馈处理完成API 商户可通过调用此接口，反馈投诉单已处理完成。
void	deleteComplaintNotifyUrl() 删除投诉通知回调地址API 当商户不再需要推送通知时，可通过调用此接口删除投诉通知的回调URL，取消通知回调。
WxMaComplaintDetailResult	getComplaint(WxMaComplaintDetailRequest request) 查询投诉单详情API 商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉内容、投诉关联订单、投诉人联系方式等信息，方便商户处理投诉。
WxMaComplaintNotifyUrlResult	getComplaintNotifyUrl() 查询投诉通知回调地址API 商户通过调用此接口查询投诉通知的回调URL。
WxMaComplaintResult	queryComplaints(WxMaComplaintRequest request) 查询投诉单列表API 商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。
WxMaNegotiationHistoryResult	queryNegotiationHistorys(WxMaNegotiationHistoryRequest request) 查询投诉协商历史API 商户可通过调用此接口，查询指定投诉的用户商户协商历史，以分页输出查询结果，方便商户根据处理历史来制定后续处理方案。
void	submitResponse(WxMaResponseRequest request) 提交回复API 商户可通过调用此接口，提交回复内容。
WxMaComplaintNotifyUrlResult	updateComplaintNotifyUrl(WxMaComplaintNotifyUrlRequest request) 更新投诉通知回调地址API 商户通过调用此接口更新投诉通知的回调URL。
String	uploadResponseImage(File imageFile) 商户上传反馈图片API 商户可通过调用此接口上传反馈图片凭证，上传成功后可在提交回复时使用。
String	uploadResponseImage(InputStream inputStream, String fileName) 商户上传反馈图片API 商户可通过调用此接口上传反馈图片凭证，上传成功后可在提交回复时使用。

方法详细资料

queryComplaints

WxMaComplaintResult queryComplaints(WxMaComplaintRequest request)
                             throws WxErrorException

 查询投诉单列表API
 商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaComplaintRequest 查询投诉单列表请求数据

返回:

WxMaComplaintResult 微信返回的投诉单列表

抛出:

WxErrorException - the wx error exception

getComplaint

WxMaComplaintDetailResult getComplaint(WxMaComplaintDetailRequest request)
                                throws WxErrorException

 查询投诉单详情API
 商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉内容、投诉关联订单、投诉人联系方式等信息，方便商户处理投诉。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaComplaintDetailRequest 投诉单详情请求数据

返回:

WxMaComplaintDetailResult 微信返回的投诉单详情

抛出:

WxErrorException - the wx error exception

queryNegotiationHistorys

WxMaNegotiationHistoryResult queryNegotiationHistorys(WxMaNegotiationHistoryRequest request)
                                               throws WxErrorException

 查询投诉协商历史API
 商户可通过调用此接口，查询指定投诉的用户商户协商历史，以分页输出查询结果，方便商户根据处理历史来制定后续处理方案。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaNegotiationHistoryRequest 请求数据

返回:

WxMaNegotiationHistoryResult 微信返回结果

抛出:

WxErrorException - the wx error exception

addComplaintNotifyUrl

WxMaComplaintNotifyUrlResult addComplaintNotifyUrl(WxMaComplaintNotifyUrlRequest request)
                                            throws WxErrorException

 创建投诉通知回调地址API
 商户通过调用此接口创建投诉通知回调URL，当用户产生新投诉且投诉状态已变更时，微信会通过回调URL通知商户。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaComplaintNotifyUrlRequest 请求数据

返回:

WxMaComplaintNotifyUrlResult 微信返回结果

抛出:

WxErrorException - the wx error exception

getComplaintNotifyUrl

WxMaComplaintNotifyUrlResult getComplaintNotifyUrl()
                                            throws WxErrorException

 查询投诉通知回调地址API
 商户通过调用此接口查询投诉通知的回调URL。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

返回:

WxMaComplaintNotifyUrlResult 微信返回结果

抛出:

WxErrorException - the wx error exception

updateComplaintNotifyUrl

WxMaComplaintNotifyUrlResult updateComplaintNotifyUrl(WxMaComplaintNotifyUrlRequest request)
                                               throws WxErrorException

 更新投诉通知回调地址API
 商户通过调用此接口更新投诉通知的回调URL。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaComplaintNotifyUrlRequest 请求数据

返回:

WxMaComplaintNotifyUrlResult 微信返回结果

抛出:

WxErrorException - the wx error exception

deleteComplaintNotifyUrl

void deleteComplaintNotifyUrl()
                       throws WxErrorException

 删除投诉通知回调地址API
 当商户不再需要推送通知时，可通过调用此接口删除投诉通知的回调URL，取消通知回调。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

抛出:

WxErrorException - the wx error exception

submitResponse

void submitResponse(WxMaResponseRequest request)
             throws WxErrorException

 提交回复API
 商户可通过调用此接口，提交回复内容。其中上传图片凭证需首先调用商户上传反馈图片接口，得到图片id，再将id填入请求。
 回复可配置文字链，传入跳转链接文案和跳转链接字段，用户点击即可跳转对应页面
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaResponseRequest 请求数据

抛出:

WxErrorException - the wx error exception

complete

void complete(WxMaCompleteRequest request)
       throws WxErrorException

 反馈处理完成API
 商户可通过调用此接口，反馈投诉单已处理完成。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

request - WxMaCompleteRequest 请求数据

抛出:

WxErrorException - the wx error exception

uploadResponseImage

String uploadResponseImage(File imageFile)
                    throws WxErrorException,
                           IOException

 商户上传反馈图片API
 商户可通过调用此接口上传反馈图片凭证，上传成功后可在提交回复时使用。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

imageFile - 需要上传的图片文件

返回:

String 微信返回的媒体文件标识Id

抛出:

WxErrorException - the wx error exception

IOException - IO异常

uploadResponseImage

String uploadResponseImage(InputStream inputStream,
                           String fileName)
                    throws WxErrorException,
                           IOException

 商户上传反馈图片API
 商户可通过调用此接口上传反馈图片凭证，上传成功后可在提交回复时使用。
 文档详见: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/guarantee/complaint.html
 

参数:

inputStream - 需要上传的图片文件流

fileName - 需要上传的图片文件名

返回:

String 微信返回的媒体文件标识Id

抛出:

WxErrorException - the wx error exception

IOException - IO异常