Antom, leading provider of tailored payment solutions

reportOccurrence

POST /v1/risk/disputes/reportOccurence

当争议发生时商户使用此接口将争议信息同步给风控团队。

入参

referenceTransactionId String  REQUIRED

用于识别交易的唯一ID。

更多信息:

  • 最大长度:64 字符

disputeId String  REQUIRED

从网关或收单机构获取的用于识别争议的唯一ID。

更多信息:

  • 最大长度:64 字符

disputeTime Datetime  REQUIRED

争议创建的日期和时间。

更多信息:

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

disputeAmount Amount  REQUIRED

存在争议的交易金额。

disputeReasonCode String  REQUIRED

从收单机构获取的引起交易争议的原因代码。

更多信息:

  • 最大长度:16 字符

disputeReasonMsg String  

从收单机构获取的争议原因说明。

更多信息:

  • 最大长度:256 字符

defenseDueTime DateTime  

为争议抗辩的截止时间,超过此时间后,您将无法进行争议抗辩。

更多信息:

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

cardBrand String  

卡品牌。请参阅卡品牌以查看有效值。

更多信息:

  • 最大长度:64 字符

issuingRegion String  

发卡国家或地区。

更多信息:

  • 最大长度:16 字符

fulfillments Array<Fulfillments>  REQUIRED

有形商品的物流状态,包括配送信息。

出参

result Result  REQUIRED

接口调用的结果。

defenseType String  REQUIRED

Antom 提供的抗辩服务类型。有效值为:

  • PREMIUM:增值服务,由 Antom 提供抗辩材料。
  • STANDARD:基础服务,商户需要自己准备抗辩材料,Antom 提供门户查询和反馈服务。
API Explorer

请求

URL
Method
POST
json
{
  "referenceTransactionId": "0656237919440001",
  "disputeId": "19823719837128972981",
  "disputeTime": "2019-11-27T12:01:01+08:00",
  "disputeAmount": {
    "currency": "USD",
    "value": "3560"
  },
  "disputeReasonCode": "10.1",
  "disputeReasonMsg": "EMV Liability Shift Counterfeit Fraud",
  "defenseDueTime": "2020-01-27T12:01:01+08:00",
  "cardBrand": "VISA",
  "issuingRegion": "US",
  "fulfillments": [
    {
      "referenceOrderId": "ORDER_0656237919440XXXX",
      "logisticOrderId": "88972137128392139",
      "logisticOrderStatus": "SHIPPED",
      "logisticProvider": "UPS"
    }
  ]
}

响应

json
{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "Successful"
  },
  "defenseType": "PREMIUM"
}

结果码

结果码值结果码信息行动建议
SUCCESSS成功。

支付成功,无需进一步操作。

PARAM_ILLEGALF缺少必需的参数,或者存在非法参数。例如,非数字输入、无效的日期,或者参数的长度和类型错误。

检查并验证当前接口所需的请求字段(包括头部字段和正文字段)是否有效传递。

SYSTEM_ERRORF发生系统错误。

请勿重试,联系 Antom 技术支持排查问题。