当某笔交易发生争议时，Antom 为您提供争议处理相关服务：

• 争议通知，并冻结争议相关交易
• 接受争议
• 拒付抗辩
• 拒付判责结果通知

支付方式争议服务

针对不同的支付方式，支持不同的争议处理流程：

表 1. 支付方式争议服务

争议处理流程

下图为争议处理流程，在您开始处理争议前，您可以联系 Antom 拒付运营团队 了解更多关于争议处理的流程及规则。

图 1. 争议处理流程

接收争议通知

当争议发生时，Antom 会向您发送争议通知，并告知争议的相关信息。您需要提前在开发者中心进行接收争议通知的地址配置。配置成功后，才可收到争议通知。争议通知的请求示例如下：

{
  "disputeAmount": {
    "currency": "EUR",
    "value": "1000"
  },
  "disputeId": "202209212501310115730104****",
  "disputeNotificationType": "DISPUTE_CREATED",
  "defenseDueTime": "2023-09-20T23:41:32-07:00",
  "disputeTime": "2022-09-20T23:41:32-07:00",
  "disputeReasonCode": "4853",
  "disputeSource": "Mastercard",
  "paymentId": "202209231540108001001888XXXXXX****",
  "paymentRequestId": "requestId_12345****"
}

争议通知中的关键字段如下（更多具体内容请参见 争议通知 接口）：

表 2. 争议通知的关键字段

收到争议通知后，您需要按 争议通知 接口的返回要求向 Antom 发送一条收到确认信息以告知 Antom 您收到了通知，否则 Antom 会重发通知。对应返回响应的示例如下：

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "Success"
  }
}

注意：

• 对于重复收到的 Antom 通知，记录下已处理的通知并做好幂等，防止同一请求多次处理。
• 您需要存储争议通知的 disputeId、paymentId、paymentRequestId 等所需要的信息，并在争议处理截止时间前对该争议进行处理。

处理争议

对于争议的处理，分为以下 4 种场景：

• 争议撤销：用户撤销争议，Antom 会给您发送异步通知，告知撤销结果。
• 接受争议：若您接受争议，您需调用 接受争议 接口通知 Antom。
• 拒付抗辩：若您不接受争议，可通过 抗辩材料下载 接口下载抗辩材料模板，通过调用 抗辩文件上传 接口上传抗辩材料进行拒付抗辩。
• 未及时处理争议：若您未及时处理，Antom 会在争议处理截止时间前的 24h 发送预警通知，提醒您及时处理争议。

争议撤销

争议发生后，您可以联系用户进行沟通协商。若用户之后选择撤销争议，Antom 会向您发送争议撤销通知。对应通知的请求示例如下：

{
  "disputeAmount": {
    "currency": "EUR",
    "value": "1000"
  },
  "disputeId": "202209212501310115730104****",
  "disputeNotificationType": "DISPUTE_CANCELLED",
  "disputeTime": "2022-09-20T23:41:32-07:00",
  "paymentId": "202209231540108001001888XXXXXX****",
  "paymentRequestId": "requestId_12345****"
}

此时通知中的 disputeNotificationType 字段值为 DISPUTE_CANCELLED。收到通知后，您需要按 争议通知 中的返回要求向 Antom 发送一条收到确认信息以告知 Antom 您收到了通知，否则 Antom 会重发通知。返回响应的示例如下：

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "Success"
  }
}

接受争议

争议发生后，若您接受争议，您可以在处理截止间时前调用 接受争议 接口（POST/v1/payments/acceptDispute），接口中传入争议通知中的 disputeId。对应的请求示例如下：

{
  "disputeId": "202401012501310115730104****"
}

当 Antom 受理您的争议接受请求后，会返回对应的受理结果。对应响应的示例如下：

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "success"
  },
  "disputeId": "2024010121013101637705928564",
  "disputeResolutionTime": "2024-01-01T18:25:00+00:00"
}

注意：请勿对同一个 disputeId 发起重复调用。若同一个 disputeId 发起重复调用，Antom 会返回 REPEAT_REQUEST，您可通过门户查看该争议单的最终受理结果或联系 Antom 进行人工确认。

之后，Antom 会向您发送拒付判责结果通知，您收到判责结果的通知后，需按判责结果通知的返回要求进行响应。

拒付抗辩

若您不接受争议，则需在争议处理截止时间前上传抗辩材料进行拒付抗辩。

步骤一：下载抗辩材料模板（可选）

通过 抗辩材料下载 接口下载抗辩材料模板，Antom 已在该模板中为您预填了部分相关信息，方便您补充材料以提高申诉的成功率（如需提前了解模板具体内容，请参见 Merchant Letter）。调用 抗辩材料下载 接口的请求示例如下：

{
  "disputeId": "202401012501310115730104****",
  "disputeEvidenceType": "DISPUTE_EVIDENCE_TEMPLATE"
}

抗辩材料下载请求中的关键字段如下（具体内容请参见 抗辩材料下载 接口）：

表 3. 抗辩材料下载请求中的关键字段

Antom 会在响应中返回对应的模板信息，您需要根据返回的文件格式做相应的解码即可获取模板文件，对应响应的示例如下：

{
  "result": {
    "resultStatus": "S",
    "resultCode": "SUCCESS",
    "resultMessage": "success."
  },
  "disputeEvidence": "Base64 Encoded File",
  "disputeEvidenceFormat": "WORD"
}

步骤二：上传抗辩材料

您需在争议处理截止时间前通过调用 抗辩文件上传 接口上传抗辩材料，接口中需传入：

• disputeId: 从拒付发生通知中获得。
• disputeEvidence: 和 disputeId 对应的抗辩材料，建议您使用 PDF 格式的材料并务必对其进行 Base64 编码。

调用 抗辩文件上传 请求的示例如下：

{
  "disputeId": "202401012501310115730104****",
  "disputeEvidence": "Base64 Encoded File"
}

当您提交抗辩材料后，您会收到上传材料成功的通知。Antom 会在响应中返回对应的受理结果，对应返回响应的示例如下：

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "success"
  },
  "disputeId": "2024010121013101637705928564",
  "disputeResolutionTime": "2024-01-01T18:25:00+00:00"
}

步骤三：补充抗辩材料（可选）

若出现抗辩材料需要补充的情况，会有拒付专员联系您，您可以通过 抗辩材料下载 接口下载之前的抗辩材料，调用 抗辩材料下载 请求的示例如下：

{
  "disputeId": "202401012501310115730104****",
  "disputeEvidenceType": "DISPUTE_EVIDENCE_FILE"
}

此时，您可以通过响应中的 disputeEvidence 得到之前的抗辩材料，并根据对应格式做解码即可。

注意：当补充完抗辩材料后，您需要联系拒付专员进行人工确认。第二次上传抗辩材料需要联系拒付专员上传，无法通过 抗辩文件上传 接口上传抗辩材料。

步骤四：接收判责结果

该笔争议的责任判定完成后，您会收到 Antom 发送的判责结果通知，此时通知中的 disputeNotificationType 字段值为 DISPUTE_JUDGED 。判责结果由 disputeJudgedResult 字段的值进行传递：

• ACCEPT_BY_CUSTOMER：买家责任。
• ACCEPT_BY_MERCHANT：商户责任。您需要承担争议损失。

收到通知后，您需要按判责结果通知中的返回要求向 Antom 发送一条收到确认信息以告知 Antom 您收到了通知。

未及时处理争议

争议发生后，若您未及时做出任何处理，Antom 会在争议处理截止时间前的 24h 再次发送预警通知，提醒您及时处理争议。对应通知的示例如下：

{
  "disputeAmount": {
    "currency": "EUR",
    "value": "1000"
  },
  "disputeId": "202401012501310115730104****",
  "disputeNotificationType": "DEFENSE_DUE_ALERT",
  "disputeTime": "2024-01-01T23:41:32-07:00",
  "defenseDueTime": "2024-01-03T23:41:32-07:00",
  "paymentId": "202401011540108001001888XXXXXX****",
  "paymentRequestId": "requestId_12345****"
}

您收到预警通知后，需要按 争议通知 接口的返回要求进行响应，向 Antom 发送一条收到确认信息以告知 Antom 您收到了通知，并在处理截止时间内对该争议订单进行处理。若您未能在截止时间前进行处理，Antom 会默认您已接受该争议。