投诉相关接口
用于商户查询与处理支付投诉，包含投诉列表、详情、处理反馈与图片操作等接口。
接口列表
| 接口 | 请求地址 | 方式 | 说明 |
|---|---|---|---|
| 投诉列表查询 | https://zfqix.com/api/complain/list | POST | 分页查询投诉记录 |
| 投诉详情查询 | https://zfqix.com/api/complain/detail | POST | 查询单条投诉详情 |
| 投诉图片上传 | https://zfqix.com/api/complain/upload | POST | 上传凭证图片，返回图片ID |
| 投诉处理反馈 | https://zfqix.com/api/complain/feedback | POST | 处理投诉（含退款/协商） |
| 回复用户 | https://zfqix.com/api/complain/reply | POST | 回复投诉用户 |
| 退款审批进度 | https://zfqix.com/api/complain/refundprogress | POST | 更新退款审批结果（仅微信） |
| 处理完成 | https://zfqix.com/api/complain/complete | POST | 反馈处理完成（仅微信） |
| 补充凭证 | https://zfqix.com/api/complain/supplement | POST | 补充处理凭证（仅支付宝） |
| 投诉图片下载 | https://zfqix.com/api/complain/image | GET | 使用平台返回的图片URL下载 |
通用签名参数
除 api/complain/image 外，其它接口均需按 签名规则 进行验签。
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
投诉列表查询
请求地址：
https://zfqix.com/api/complain/list
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 页码 | page_num | 否 | Int | 1 | 默认1 |
| 每页数量 | page_size | 否 | Int | 20 | 默认20 |
| 支付方式 | pay_type | 否 | String | alipay | 参考支付方式列表 |
| 开始日期 | begin_date | 否 | String | 2025-01-01 | 格式：YYYY-MM-DD |
| 结束日期 | end_date | 否 | String | 2025-01-31 | 格式：YYYY-MM-DD |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
返回参数说明：
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 返回状态码 | code | Int | 0 | 0为成功，其它值为失败 |
| 返回信息 | msg | String | 失败时返回原因 | |
| 总记录数 | data.total | Int | 5 | 投诉总数量 |
| 数据列表 | data.rows | Array | 包含 id/pay_type/trade_no/out_trade_no/problem_type/problem_description/complaint_content/status/phone/addtime/edittime/order_money/order_name 等 |
投诉详情查询
请求地址：
https://zfqix.com/api/complain/detail
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
返回参数说明：
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 返回状态码 | code | Int | 0 | 0为成功，其它值为失败 |
| 返回信息 | msg | String | 失败时返回原因 | |
| 通道类型 | showtype | String | wxpay | 支付宝/微信/风控等 |
| 投诉详情 | data | Object | 包含 pay_type/problem_type/problem_description/complaint_content/images/reply_detail_infos/out_trade_no/order_money/order_name 等 |
投诉图片上传
请求地址：
https://zfqix.com/api/complain/upload
请求方式：
POST（multipart/form-data）
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 图片文件 | file | 是 | File | 上传凭证图片 | |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
返回说明：
成功时返回图片ID（字段名通常为 image_id），用于后续处理接口的 images 参数。
投诉处理反馈
请求地址：
https://zfqix.com/api/complain/feedback
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 处理方式 | code | 否 | String | 1 | 支付宝处理时需传，具体值以通道要求为准 |
| 处理内容 | content | 否 | String | 已与买家协商 | 支付宝处理时必填 |
| 图片ID数组 | images | 否 | Array | ["xxx"] | 由上传接口返回的图片ID |
| 处理完成 | complete | 否 | Int | 1 | 仅微信可用，传1自动调用完成 |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
说明：支付宝投诉需要 code 与 content；微信投诉可通过 complete=1 完成处理。
回复用户
请求地址：
https://zfqix.com/api/complain/reply
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 回复内容 | content | 是 | String | 已联系买家处理 | 必填 |
| 图片ID数组 | images | 否 | Array | ["xxx"] | 由上传接口返回的图片ID |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
退款审批进度（仅微信）
请求地址：
https://zfqix.com/api/complain/refundprogress
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 审批结果 | code | 是 | String | 0 | 0拒绝/1同意，具体以通道要求为准 |
| 处理说明 | content | 否 | String | 拒绝理由 | 当 code=0 时必填 |
| 备注 | remark | 否 | String | 附加说明 | 选填 |
| 图片ID数组 | images | 否 | Array | ["xxx"] | 由上传接口返回的图片ID |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
处理完成（仅微信）
请求地址：
https://zfqix.com/api/complain/complete
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
补充凭证（仅支付宝）
请求地址：
https://zfqix.com/api/complain/supplement
请求方式：
POST
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 投诉ID | id | 是 | Int | 98 | 投诉记录ID |
| 凭证内容 | content | 是 | String | 补充说明 | 必填 |
| 图片ID数组 | images | 否 | Array | ["xxx"] | 由上传接口返回的图片ID |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数，单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
投诉图片下载
投诉详情返回的 images 中已包含可直接访问的图片链接，推荐直接使用链接进行下载。
请求地址：
https://zfqix.com/api/complain/image
请求方式：
GET
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 通道ID | channel | 是 | Int | 12 | 通道ID |
| 子通道ID | subchannel | 否 | Int | 0 | 有则传 |
| 媒体ID | mediaid | 是 | String | xxx | 图片媒体标识 |
| 时间戳 | time | 是 | String | 1721206072 | 有效期5分钟 |
| 签名 | sign | 是 | String | 由平台生成的签名 |