com.github.binarywang.wxpay.service

接口 ComplaintService

所有已知实现类:

ComplaintServiceImpl

public interface ComplaintService

 微信支付 消费者投诉2.0 API.
 Created by jmdhappy on 2022/3/19.
 

作者:

jmdhappy

方法概要

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

方法详细资料

queryComplaints

ComplaintResult queryComplaints(ComplaintRequest request)
                         throws WxPayException,
                                BadPaddingException

 查询投诉单列表API
 商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。
 对于服务商、渠道商，可通过调用此接口，查询指定子商户号对应子商户的投诉信息，若不指定则查询所有子商户投诉信息。
 文档详见: ...
 

参数:

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

返回:

ComplaintResult 微信返回的投诉单列表

抛出:

WxPayException - the wx pay exception

BadPaddingException - .

getComplaint

ComplaintDetailResult getComplaint(ComplaintDetailRequest request)
                            throws WxPayException,
                                   BadPaddingException

 查询投诉单详情API
 商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉内容、投诉关联订单、投诉人联系方式等信息，方便商户处理投诉。
 文档详见: ...
 

参数:

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

返回:

ComplaintDetailResult 微信返回的投诉单详情

抛出:

WxPayException - the wx pay exception

BadPaddingException - .

queryNegotiationHistorys

NegotiationHistoryResult queryNegotiationHistorys(NegotiationHistoryRequest request)
                                           throws WxPayException

 查询投诉协商历史API
 商户可通过调用此接口，查询指定投诉的用户商户协商历史，以分页输出查询结果，方便商户根据处理历史来制定后续处理方案。
 文档详见: ...
 

参数:

request - NegotiationHistoryRequest 请求数据

返回:

NegotiationHistoryResult 微信返回结果

抛出:

WxPayException - the wx pay exception

addComplaintNotifyUrl

ComplaintNotifyUrlResult addComplaintNotifyUrl(ComplaintNotifyUrlRequest request)
                                        throws WxPayException

 创建投诉通知回调地址API
 商户通过调用此接口创建投诉通知回调URL，当用户产生新投诉且投诉状态已变更时，微信支付会通过回 调URL通知商户。对于服务商、渠道商，会收到所有子商户的投诉信息推送。
 文档详见: ...
 

参数:

request - ComplaintDetailRequest 请求数据

返回:

ComplaintNotifyUrlResult 微信返回结果

抛出:

WxPayException - the wx pay exception

getComplaintNotifyUrl

ComplaintNotifyUrlResult getComplaintNotifyUrl()
                                        throws WxPayException

 查询投诉通知回调地址API
 商户通过调用此接口查询投诉通知的回调URL。
 文档详见: ...
 

返回:

ComplaintNotifyUrlResult 微信返回结果

抛出:

WxPayException - the wx pay exception

updateComplaintNotifyUrl

ComplaintNotifyUrlResult updateComplaintNotifyUrl(ComplaintNotifyUrlRequest request)
                                           throws WxPayException

 更新投诉通知回调地址API
 商户通过调用此接口更新投诉通知的回调URL。
 文档详见: ...
 

参数:

request - ComplaintDetailRequest 请求数据

返回:

ComplaintNotifyUrlResult 微信返回结果

抛出:

WxPayException - the wx pay exception

deleteComplaintNotifyUrl

void deleteComplaintNotifyUrl()
                       throws WxPayException

 删除投诉通知回调地址API
 当商户不再需要推送通知时，可通过调用此接口删除投诉通知的回调URL，取消通知回调。
 文档详见: ...
 

抛出:

WxPayException - the wx pay exception

submitResponse

void submitResponse(ResponseRequest request)
             throws WxPayException

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

参数:

request - ResponseRequest 请求数据

抛出:

WxPayException - the wx pay exception

complete

void complete(CompleteRequest request)
       throws WxPayException

 反馈处理完成API
 商户可通过调用此接口，反馈投诉单已处理完成。
 文档详见: ...
 

参数:

request - CompleteRequest 请求数据

抛出:

WxPayException - the wx pay exception

uploadResponseImage

ImageUploadResult uploadResponseImage(File imageFile)
                               throws WxPayException,
                                      IOException

 商户上传反馈图片API
 文档详见: ...
 接口链接：https://api.mch.weixin.qq.com/v3/merchant-service/images/upload
 

参数:

imageFile - 需要上传的图片文件

返回:

ImageUploadResult 微信返回的媒体文件标识Id。示例值：BB04A5DEEFEA18D4F2554C1EDD3B610B.bmp

抛出:

WxPayException - the wx pay exception

IOException

uploadResponseImage

ImageUploadResult uploadResponseImage(InputStream inputStream,
                                      String fileName)
                               throws WxPayException,
                                      IOException

 商户上传反馈图片API
 文档详见: ...
 接口链接：https://api.mch.weixin.qq.com/v3/merchant-service/images/upload
 

参数:

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

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

返回:

ImageUploadResult 微信返回的媒体文件标识Id。示例值：BB04A5DEEFEA18D4F2554C1EDD3B610B.bmp

抛出:

WxPayException - the wx pay exception

IOException