Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

争议通知

Antom 使用此接口向商户发送争议信息。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：


注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

  • 如果字段的数据类型为整数属性，且其值为 20，设置为 "20"。
  • 如果字段的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

paymentRequestId String  REQUIRED

商户为识别支付请求而分配的专属 ID。

更多信息：

  • 最大长度：64 字符

disputeId String  REQUIRED

Antom 为识别争议而分配的争议 ID。

更多信息：

  • 最大长度：64 字符

paymentId String  REQUIRED

Antom 为识别支付而分配的支付 ID。

更多信息：

  • 最大长度：64 字符

disputeTime Datetime  

争议创建的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

disputeAmount Amount object 

存在争议的交易金额。

注意：当发生争议时返回此参数。

Show child parameters

disputeNotificationType String  REQUIRED

争议通知的类型。有效值包括：

  • DISPUTE_CREATED: 表示发生了争议。
  • DISPUTE_JUDGED: 表示争议已被裁决。
  • DISPUTE_CANCELLED: 表示用户已取消争议。 
  • DEFENSE_SUPPLIED: 表示您已提交了争议的辩护文件。
  • DEFENSE_DUE_ALERT: Antom 发出的警告，通知您在 defenseDueTime 后的 24 小时内，您的辩护即将过期。

更多信息：

  • 最大长度：30 字符

disputeReasonMsg String  

争议的理由。

更多信息：

  • 最大长度：256 字符

disputeJudgedTime Datetime  

争议裁决的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

disputeJudgedAmount Amount object 

争议的扣款金额。

注意：当争议被裁决时返回此参数。

Show child parameters

disputeJudgedResult String  

争议裁决结果。有效值为：

  • ACCEPT_BY_CUSTOMER：表示争议由客户负责。Antom解冻请款资金，您可以自由处理这笔资金。
  • ACCEPT_BY_MERCHANT：表示争议由商户负责。Antom解冻请款资金，但是会从您的结算账户中扣除以退还给买家。

更多信息：

  • 最大长度：30 字符

defenseDueTime Datetime  

您无法辩护争议的截止时间。

注意：当 disputeNotificationType 的值为DISPUTE_CREATED或DEFENSE_DUE_ALERT时，此参数返回。

disputeReasonCode String  

表明支付被争议的原因代码。有关原因代码的详细信息，请参阅拒付原因码。

注意：当 disputeNotificationType 的值为DISPUTE_CREATED或DISPUTE_JUDGED时，返回此参数。

更多信息：

  • 最大长度：64 字符

disputeSource String  

负责处理争议的银行卡组织。

注意：当 disputeNotificationType 的值为DISPUTE_CREATED或DISPUTE_JUDGED时，返回此参数。

更多信息：

  • 最大长度：64 字符

arn String  

争议的收单机构参考号（ARN）。

注意：当 disputeNotificationType 的值为DISPUTE_CREATED时，此参数返回。

更多信息：

  • 最大长度：64 字符

disputeAcceptReason string  

接受争议的原因。

注意：当 disputeNotificationType 的值为 DISPUTE_ACCEPTED时，请指定此参数。 有效值包括：

  • RAPID_DISPUTE_RESOLUTION: 表示由于快速争议解决（RDR）而接受争议。
  • MERCHANT_ACCEPTED: 表示接受由商户发起的争议。
  • TIMEOUT: 表示由于超时场景而接受争议，即如果商户未能在指定时间内对争议进行抗辩，则争议将被自动接受。
  • MANUAL_PROCESSING_ACCEPTED: 表示由于手动处理而接受争议。

disputeAcceptTime Datetime  

争议被接受的时间。

注意：当 disputeNotificationType 的值为 DISPUTE_ACCEPTED时，请指定此参数。

出参

result Result object REQUIRED

发送给 Antom 以确认已收到通知的固定值。

Show child parameters
API Explorer

请求

Case
Notification about an occurred dispute
请求体

响应

响应体

结果码

结果码值结果码信息
SUCCESSS成功