reportRisk

2023-11-24 05:35

POST /v1/risk/payments/reportRisk

使用该接口向蚂蚁集团通知风险情况。该接口用于未来的风险评估，蚂蚁集团会根据历史风险情况相应升级风控策略。

结构

报文由报文头和报文体构成，下文主要介绍报文体结构。

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

如果某个字段的数据类型为 Integer 且值为 20，则将其设置为 “20”。
如果某个字段的数据类型为 Boolean 且值为 true，则将其设置为 “true ”。

Request parameters

referenceTransactionId String REQUIRED

直接向买家提供服务或商品的商户分配的唯一ID，用于识别交易。

More information:

Maximum length: 64 characters

reportReason String

上报的原因。

提供这些信息有助于提升欺诈检测的准确性，提高支付成功率。

More information:

Maximum length: 2048 characters

riskType String

上报的风险类型。有效值为：

SUSPICIOUS：表示该交易被商户视为有风险，例如买家命中了商户的黑名单。
CHARGEBACK：表示买家发起了拒付。
FRAUD：表示发生了卡盗刷行为。

提供这些信息有助于提升欺诈检测的准确性，提高支付成功率。

More information:

Maximum length: 16 characters

riskOccurrenceTime Datetime REQUIRED

表示风险事件发生的时间，定义如下：

如果 riskType 值为 SUSPICIOUS，该字段的值为您识别该风险交易的时间。
如果 riskType 的值为 CHARGEBACK，该字段的值为支付方式向您发送的通知中包含的拒付发生时间。
如果 riskType 的值为 FRAUD，该字段的值为支付方式向您发送的通知中包含的盗卡发生时间。

More information:

Maximum length: 64 characters
The value follows the ISO 8601 standard format. For example, "2019-11-27T12:01:01+08:00".

Response parameters

result Result REQUIRED

接口调用的结果。

Show child parameters

API Explorer

Sample CodesRun in Sandbox

Request

URL

Request Body

Response

Response Body

Result/Error codes

Code	Value	Message	Further action
SUCCESS	S	成功	接口调用成功，无需执行任何操作。
ACCESS_DENIED	F	访问被拒绝。	详细原因请联系蚂蚁集团技术支持。
INVALID_API	F	调用的接口无效或未激活。	请联系蚂蚁集团技术支持解决问题。
INVALID_CONTRACT	F	合约中的参数值与当前交易中的参数值不匹配。	检查合约中的参数值是否与当前交易中的参数值匹配。如果匹配，请联系蚂蚁集团技术支持排查问题。
KEY_NOT_FOUND	F	未找到蚂蚁集团或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在蚂蚁集团开发者中心上传私钥。
MERCHANT_KYB_NOT_QUALIFIED	F	由于商家的 KYB 状态，支付失败。该商户可能不符合 KYB 标准，或者 KYB 状态不符合此交易的条件。	详细原因请联系蚂蚁集团技术支持。
MERCHANT_NOT_REGISTERED	F	商户未注册。	请通过注册接口注册商户。如果调用注册接口失败，请联系蚂蚁集团技术支持。
NO_INTERFACE_DEF	F	接口未定义	检查 URL 是否正确。请参见接口文档中的端点。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超出限制。	再次调用该接口解决问题。若未解决，请联系蚂蚁集团技术支持。
PARAM_ILLEGAL	F	没有传递必传参数，或者存在非法参数。例如，非数字输入、无效日期或参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括请求头字段和请求体字段）是否正确传递且有效。
SYSTEM_ERROR	F	发生系统错误。	请勿重试，请联系蚂蚁集团技术支持了解更多详情。
UNKNOWN_EXCEPTION	U	接口调用失败，原因未知。	再次调用接口解决问题。如仍未解决，请联系蚂蚁集团技术支持。