reportOccurrence
当争议发生时商户使用此接口将争议信息同步给风控团队。
入参
referenceTransactionId String REQUIRED
用于识别交易的唯一ID。
更多信息:
- 最大长度:64 字符
disputeId String REQUIRED
从网关或收单机构获取的用于识别争议的唯一ID。
更多信息:
- 最大长度:64 字符
disputeAmount Amount REQUIRED
存在争议的交易金额。
disputeReasonCode String REQUIRED
从收单机构获取的引起交易争议的原因代码。
更多信息:
- 最大长度:16 字符
disputeReasonMsg String
从收单机构获取的争议原因说明。
更多信息:
- 最大长度:256 字符
defenseDueTime DateTime
为争议抗辩的截止时间,超过此时间后,您将无法进行争议抗辩。
更多信息:
- 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。
issuingRegion String
发卡国家或地区。
更多信息:
- 最大长度:16 字符
fulfillments Array<Fulfillments> REQUIRED
有形商品的物流状态,包括配送信息。
出参
result Result REQUIRED
接口调用的结果。
defenseType String REQUIRED
Antom 提供的抗辩服务类型。有效值为:
PREMIUM:增值服务,由 Antom 提供抗辩材料。STANDARD:基础服务,商户需要自己准备抗辩材料,Antom 提供门户查询和反馈服务。
API Explorer
请求
URL
Method
POST
{
"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"
}
]
}响应
{
"result": {
"resultCode": "SUCCESS",
"resultStatus": "S",
"resultMessage": "Successful"
},
"defenseType": "PREMIUM"
}结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 支付成功,无需进一步操作。 |
| PARAM_ILLEGAL | F | 缺少必需的参数,或者存在非法参数。例如,非数字输入、无效的日期,或者参数的长度和类型错误。 | 检查并验证当前接口所需的请求字段(包括头部字段和正文字段)是否有效传递。 |
| SYSTEM_ERROR | F | 发生系统错误。 | 请勿重试,联系 Antom 技术支持排查问题。 |