投诉接口
投诉接口用于商户系统同步微信 / 支付宝支付投诉工单，并完成回复用户、上传凭证、反馈处理方案、查询退款进度、完结投诉等操作。
通用说明
除图片下载接口外，所有投诉接口均使用 POST 提交，需携带公共参数 pid、timestamp、sign、sign_type，详见 接口说明 与 签名规则。响应统一为 JSON，code=0 表示成功。
| 接口 | 地址 | 签名 | 说明 |
|---|---|---|---|
| 投诉列表 | /api/complain/list | 是 | 分页查询投诉工单，返回 total / rows |
| 投诉详情 | /api/complain/detail | 是 | 查询单条投诉详情、用户留言与凭证 |
| 图片下载 | /api/complain/image | 否 | 代理下载投诉中的图片资源（GET） |
| 图片上传 | /api/complain/upload | 是 | 上传回复 / 举证图片（multipart/form-data） |
| 回复用户 | /api/complain/reply | 是 | 向投诉人回复处理意见，可附图片 |
| 反馈方案 | /api/complain/feedback | 是 | 向支付机构反馈协商方案（退款 / 不退款） |
| 退款进度 | /api/complain/refundprogress | 是 | 发起 / 查询退款处理进度，可附凭证 |
| 补充凭证 | /api/complain/supplement | 是 | 向支付机构补充举证材料 |
| 完结投诉 | /api/complain/complete | 是 | 协商一致后完结工单 |
1. 投诉列表
请求地址
https://htpay.wenshuabao.cn/api/complain/list
请求参数
| 字段 | 变量名 | 必填 | 说明 |
|---|---|---|---|
| 页码 | page | 否 | 默认 1 |
| 每页数量 | limit | 否 | 默认 10 |
返回示例
{
"code": 0,
"data": { "total": 0, "rows": [] }
}rows 中每条工单包含平台投诉单号 id（后续操作接口均使用该 id）、支付渠道投诉单号、订单信息、投诉问题类型、投诉内容、投诉时间、工单状态等字段，具体以实际返回为准。
2. 投诉详情
POST /api/complain/detail
| 字段 | 变量名 | 必填 | 说明 |
|---|---|---|---|
| 平台投诉单号 | id | 是 | 列表接口返回的 id |
3. 图片上传
POST /api/complain/upload，使用 multipart/form-data 提交图片文件（表单文件字段为 file），签名仅对普通表单参数计算（文件不参与签名）。成功后返回图片标识 / 地址，用于回复、举证接口的 images 参数。
4. 回复用户
POST /api/complain/reply
| 字段 | 变量名 | 必填 | 说明 |
|---|---|---|---|
| 平台投诉单号 | id | 是 | 列表接口返回的 id |
| 回复内容 | content | 是 | 向投诉人说明的处理意见，不可为空 |
| 图片凭证 | images[] | 否 | 先调用图片上传接口，将返回的图片标识以数组方式提交；无图片时传空数组 images[]= |
5. 反馈协商方案
POST /api/complain/feedback，必填 id 及支付机构要求的处理方案参数（反馈类型、反馈内容等，不能为空）。同意退款的须随后通过 退款接口 发起退款并调用退款进度接口同步。
6. 查询/提交退款进度
POST /api/complain/refundprogress，必填 id；如已发起退款，可附退款凭证 images[]（无图片时传空数组），用于向支付机构同步处理进度。
7. 补充凭证
POST /api/complain/supplement，必填 id、content（凭证说明，不可为空）与 images[]（图片凭证数组，无图片时传空数组）。
8. 完结投诉
POST /api/complain/complete，必填 id。与用户协商一致（用户确认解决或已退款）后调用，工单完结后不可再回复。
处理时限与建议
- 请在支付机构规定时限内（通常为 48 小时）及时响应投诉，避免资金被限制或处罚；
- 推荐流程：拉取列表 → 查看详情 → reply 回复用户 → 协商退款则走退款接口 → refundprogress 同步 → complete 完结；
- 涉及物流、聊天记录等证据，请先 upload 上传，再通过 supplement 或 reply 的 images 提交。