接口说明

接口名称 complaint_response
是否幂等 否
接口模式 直连
异步通知 否

应用场景：

商户可通过调用此接口，提交回复内容。其中上传图片凭证需首先调用商户上传反馈图片接口，得到图片id，再将id填入请求。 回复可配置文字链，传入跳转链接文案和跳转链接字段，用户点击即可跳转对应页面。

注意事项：

如果业务结果：resultCode = SUCCESS，则表示处理成功

接口参数

  • 请求
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
交易商户号 merId 是 S(16)
交易终端号 terId 是 S(16)
投诉单号 complaintId 是 S(32) 200201820200101080076610000 投诉单对应的被诉商户号
被诉商户号 complaintedMchid 否 S(32) 1900012181 投诉单对应的被诉商户号
回复内容

responseContent

 是 I 已与用户沟通解决 具体的投诉处理方案，限制200个字符以内。
回复图片 responseImages 否 C [“file23578_21798531.jpg”,”file23578_228.jpg”] 传入调用商户上传反馈图片接口返回的media_id，最多上传4张图片凭证
跳转链接 jumpUrl 否 https://www.xxx.com/notify

商户可在回复中附加跳转链接，引导用户跳转至商户客诉处理页面，链接需满足https格式

注：配置文字链属于灰度功能, 若有需要请使用超管邮箱，按照要求发送邮件申请。邮件要求详情见：
跳转链接文案 jumpUrlText 否 查看订单详情

实际展示给用户的文案，附在回复内容之后。用户点击文案，即可进行跳转。

注:若传入跳转链接，则跳转链接文案为必传项，二者缺一不可。
  • 返回
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
商户号 merId 是 S(16) 100000 宝付支付分配的商户号
终端号 terId 是 S(16) 100000 宝付支付分配的终端号
投诉单号 complaintId 否 S(32) 200201820200101080076610000 与商户订单号对应的宝付侧唯一订单号，推荐传入此值
被诉商户号 complaintedMchid 否 S(32) 1900012181 商户系统内部订单号，同一个商户号下唯一
业务结果 resultCode 是 S(16) SUCCESS

SUCCESS：成功

FAIL：失败
错误代码 errCode 否 S(32) 当业务结果FAIL时，返回错误代码
错误描述 errMsg 否 S(128) 当业务结果为FAIL时，返回错误描述
作者：郑成定  创建时间：2026-05-22 15:11
最后编辑：郑成定  更新时间：2026-09-17 19:13