查询投诉单协商历史

更新时间:2023.08.16

商户可通过调用此接口,查询指定投诉单的用户与商户的协商历史,以分页输出查询结果,方便商户根据处理历史来制定后续处理方案。

# 接口说明

支持商户:
【普通服务商】【从业机构(银行)】【从业机构(支付机构)】【渠道商】【清算机构】
请求方式:
【GET】/v3/merchant-service/complaints-v2/{complaint_id}/negotiation-historys
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Path 路径参数
  • complaint_id 必填 string(64)
    【投诉单号】 投诉单对应的投诉单号
    Query 查询参数
  • limit 选填 integer
    【分页大小】 设置该次请求返回的最大协商历史条数,范围[1,300]
  • offset 选填 integer
    【分页开始位置】 该次请求的分页开始位置,从0开始计数,例如offset=10,表示从第11条记录开始返回。

请求示例

GET

# 应答参数

    200OK
  • data 选填 array[ComplaintNegotiationHistoryWithLogId]
    【投诉协商历史】 投诉协商历史
    • 属性
  • limit 必填 integer
    【分页大小】 设置该次请求返回的最大协商历史条数,范围[1,300]
  • offset 必填 integer
    【分页开始位置】 设置该次请求返回的最大协商历史条数,范围[1,300]
  • total_count 选填 integer
    【投诉协商历史总条数】 投诉协商历史总条数,当offset=0时返回

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则项 请确认参数符合业务要求,稍后重新调用
403 NO_AUTH 无权限 请开通商户号权限,并确认参数符合规范
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
反馈
咨询
目录