常见问题
更新时间：2026.04.28Q:创建投诉通知回调地址返回{"code":"INVALID_REQUEST","message":"头部信息不完整"}
A:请检查请求头Accept或User-Agent是否缺失，并且需要按照apiv3标准设置请求头Authorization，具体参考如何构造请求签名-设置HTTP头。
Q:调用图片上传接口处理用户投诉时报错{"code":"NO_AUTH";"message":"您暂无权限为该投诉单提交商户回复"}
A:不能跨商户号回复客诉，例如A商户的客诉，不能由B商户回复。
Q：消费者投诉API接口处理投诉和合作伙伴平台处理投诉，功能操作上会有冲突吗？
A：接口和合作伙伴平台操作的都是同一笔投诉单，接口操作处理完成了，合作伙伴平台就无需处理。不过并发操作会有冲突，建议错开时间进行操作。
Q：消费者投诉2.0调用更新退款审批结果接口报错：当前单据状态不支持操作, 请检查是否重复调用。
A：已调用过更新退款审批结果接口再次调用或者订单已完成退款将报该错误。
Q：查询投诉单返回的图片链接打不开，如何查看图片？
A：投诉图片链接不支持直接打开。请按APIv3标准调用图片请求接口，从接口获取图片的二进制数据流，将其保存为本地图片文件后再进行展示。
Q：回复用户接口报错：{"code":"NO_AUTH","message":"此商户号暂不支持发送外部链接，如有需要请联系对接的微信支付行业运营评估配置"}，什么原因？
A：发送外部链接需要联系对接的微信支付行业运营评估配置，才能使用。
Q：消费者投诉接口中，用户首次投诉与继续投诉返回的complaint_id是否一致？
A：是的，一致。
Q：退款投诉单，是否是先调用回复用户接口，再调用更新退款审批结果接口进行退款判断？
A：是的。
Q：图片上传接口返回的media_id有效期是多久？
A：media_id没有时效性，一直有效。
Q：查询投诉单协商历史可以查询多久内的投诉单号？
A：无时效限制。
Q：同一笔交易订单用户是否可以多次投诉？
A：可以，同一笔交易订单多次投诉只会生成一笔投诉单号。
Q：查询投诉单详情接口返回的problem_type【问题类型】是申请退款，必须调用“更新退款审批结果”接口吗？
A：推荐使用，非强制性，处理完成后也可使用反馈处理完成接口。
Q：同一个订单多次投诉，查询投诉单详情接口为何只返回首次投诉信息？二次投诉信息如何获取？
A：查询投诉单详情接口仅返回首次投诉内容，二次投诉信息需调用查询投诉单协商历史接口获取。
Q： 商户平台投诉单的【用户是否升级投诉】字段如何通过接口获取？对应哪个字段？
A：通过查询投诉单详情接口返回的user_complaint_times【用户投诉次数】字段区分：
首次咨询：字段值为 1
升级投诉：字段值为 2（用户首次升级）
多次升级投诉：字段值 ≥3（用户重复升级）
Q：消费者投诉 API 中的【回复用户】接口与【回复需要即时服务的投诉单】接口有何区别？商家收到投诉后应如何选择调用？
A： 两者的主要区别在于处理时效要求与问题严重程度，具体对比如下：
接口名称 | 适用场景 | 调用时机 |
|---|---|---|
回复用户 | 适用于普通投诉的处理。此类问题通常不涉及紧急风险，解决周期相对宽松。 | 当消费者投诉内容较为常规（如咨询类、非紧急的体验问题），无需立即采取行动或即时反馈时，调用此接口进行文本回复或补充说明。 |
回复需要即时服务的投诉单 | 适用于高风险或紧急性投诉。此类问题可能对用户权益、人身安全或核心服务造成直接影响，需优先处置。 | 当投诉涉及服务中断、安全隐患、资金风险等需要立即响应和解决的情形时，应优先调用此接口，以确保消费者获得及时援助。 |
总结建议：
请优先评估投诉单的紧急程度。涉及用户切身利益或急需解决的，使用【回复需要即时服务的投诉单】；常规问题则使用【回复用户】接口。
