微信投诉处理-接入指引
最近更新时间:2023.7.17
1.产品介绍
1.1简介
斗拱为渠道商/商户提供一套在微信侧进行消费者投诉模块的申诉处理功能,在渠道商/商户登陆控台后使用该功能可大大减少在微信侧的交互。
1.2相关能力应用场景
查询渠道在微信被投诉的记录,包括两部分:
- 被投诉的清单列表;
- 商户调用此接口,查询指定时间段的所有用户投诉信息,以分页输出查询结果。
- 服务商、渠道商调用此接口,查询指定特约商户号下的投诉信息。若不指定,则查询的是名下所有特约商户投诉信息。
- 单笔投诉单的详细信息;查询指定投诉单的用户投诉详情,包含投诉关联订单信息/支付分服务单信息、投诉的问题类型、问题描述、投诉人联系方式等信息,方便商户处理投诉。
1.3适用对象
微信的渠道商。微信要求如果不及时处理投诉单渠道商会被降级。
2.接入前准备
3.开发指引
3.1对接规范
- 请求方式:POST
- 支持格式:JSON
- 加签验签说明:请参考接入指引-开发指南
3.2系统接口
3.2.1查询投诉单列表及详情
入参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
sys_id | 商户/渠道商汇付Id | 渠道商/商户在汇付侧分配的id |
huifu_id | 被投诉的商户ID | |
transaction_id | 微信订单号 | 示例值:4200001625202210202723751004;有值查指定订单号的投诉信息,为空则查询商户下的所有投诉信息 |
complaint_id | 微信投诉订单号 | 示例值:200000020221020130032510333;有值查指定投诉单号的投诉信息,为空则查询商户下的所有投诉信息 |
complaint_state | 投诉状态 | 待处理:待处理,PROCESSING:处理中,PROCESSED:已处理完成 |
返参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
total_count | 投诉总条数 | 条数过多需要分页处理 |
complaint_list | 用户投诉详情 | 包括:投诉单号、投诉详情、投诉时间等 |
3.2.2查询投诉协商历史
入参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
complaint_id | 微信投诉订单号 | 示例值:200000020221020130032510333;有值查指定投诉单号的投诉信息,为空则查询商户下的所有投诉信息 |
mch_id | 微信商户号 | 微信从业机构号 |
返参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
total_count | 投诉总条数 | 条数过多需要分页处理 |
complaint_history_list | 投诉协商历史 | 包括投诉资料列表(内涵图片文件信息)、操作内容等 |
3.3.3回复用户
入参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
complaint_id | 微信投诉订单号 | 示例值:200000020221020130032510333;有值查指定投诉单号的投诉信息,为空则查询商户下的所有投诉信息 |
complainted_mchid | 被投诉微信商户号 | 被投诉的微信商户号 |
response_content | 回复内容 | 回复具体的解决方案,200字符以内 |
mch_id | 微信商户号 | 微信从业机构号 |
file_info | 文件列表 | 最多可上传4张图片 |
返参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
resp_desc | 返回描述 |
3.3.4反馈处理完成
入参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
complaint_id | 微信投诉订单号 | 示例值:200000020221020130032510333;有值查指定投诉单号的投诉信息,为空则查询商户下的所有投诉信息 |
complainted_mchid | 被投诉微信商户号 | 被投诉的微信商户号 |
mch_id | 微信商户号 | 微信从业机构号 |
返参需关注以下字段:
参数 | 中文名 | 说明 |
---|---|---|
resp_desc | 返回描述 |
4.API列表
类型 | 功能 | 描述 |
---|---|---|
应用程序接口 | 查询投诉单列表及详情 | 查询渠道在微信被投诉的记录 |
应用程序接口 | 查询投诉协商历史 | 商户可通过调用此接口,查询指定投诉单的用户与商户的协商历史,以分页输出查询结果,方便商户根据处理历史来制定后续处理方案。 |
应用程序接口 | 投诉图片下载 | 消费者投诉相关图片都可以通过该接口进行下载。 |
应用程序接口 | 回复用户 | 商户可通过调用此接口,提交内容回复用户。 |
应用程序接口 | 更新退款审批结果 | 商户可通过调用此接口,更新"申请退款"单据的退款审批结果。 |
应用程序接口 | 反馈处理完成 | 商户可通过调用此接口,反馈投诉单已处理完成。 |