# 争议状态通知

当产生新的争议时,支付网关会向商户系统发起回调通知。如果商户系统没有正确返回,支付网关会延迟再次通知。

# 通知

接口

请求URL: 该链接是通过商户应用配置中的 disputeNotifyUrl 设置,如果无法访问链接,商户系统将无法接收到争议通知。

请求方式: POST

请求类型:application/x-www-form-urlencoded

# 通知参数

字段名 变量名 必填 类型 示例值 描述
争议日志ID disputeLogId long 10001 此次通知对应的争议变更日志ID
争议ID disputeId String(30) D202512101104177050001 平台争议ID
支付订单号 payOrderId String(30) P12021022311124442600 关联的支付系统订单号
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
争议金额 amount long 100 争议金额,单位分
货币代码 currency String(3) USD 三位货币代码
争议阶段 status String(50) first_chargeback_under_review 争议状态
原因码 reasonCode String(32) 10.4 渠道返回的争议原因代码
原因描述 reasonMsg String(256) Fraud 渠道返回的争议原因描述
响应截止 responseDeadline long 1622016572190 响应截止时间,13位时间戳
通知请求时间 reqTime long 1622016572190 通知请求时间,13位时间
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法

# 返回结果

业务系统处理后同步返回给支付中心,返回字符串 success 则表示已处理,如处理发生异常返回非success则表示处理失败,支付中心会再次通知业务系统。(通知频率为0/30/60/90/120/150,单位:秒)

状态 业务系统Response
处理成功 success
处理失败 fail (或其他非success字符串)

注意

返回的字符串必须是小写,且前后不能有空格和换行符。

# 通知示例数据

mchNo=M1621873433953&appId=60cc09bce4b0f1c0b83761c9&disputeId=D202512101104177050001&disputeLogId=10001&payOrderId=P12021022311124442600&amount=100&currency=USD&status=CHARGEBACK&reasonCode=10.4&reasonMsg=Fraud&responseDeadline=1624590257000&reqTime=1622016572190&sign=C380BEC2BFD727A4B6845133519F3AD6
Last Updated: 2025/12/24 上午10:30:26