接口说明

接口名称 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时,返回错误描述
作者:xiaofeng  创建时间:2025-03-25 16:54
最后编辑:xiaofeng  更新时间:2025-06-05 10:43