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

reportRisk

POST /v1/risk/payments/reportRisk

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

结构

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

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

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

入参

referenceTransactionId String  REQUIRED

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

更多信息：

  • 最大长度：64 字符

reportReason String  

上报的原因。

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

更多信息：

  • 最大长度：2048 字符

riskType String  

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

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

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

更多信息：

  • 最大长度：16 字符

riskOccurrenceTime Datetime  REQUIRED

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

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

更多信息：

  • 最大长度：64 字符
  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

出参

result Object  REQUIRED

接口调用的结果。

Show child parameters
API Explorer
示例代码沙箱运行

请求

URL

请求体

响应

响应体

结果码

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

接口调用成功，无需执行任何操作。

ACCESS_DENIEDF访问被拒绝。

详细原因请联系蚂蚁集团技术支持。

INVALID_APIF调用的接口无效或未激活。

请联系蚂蚁集团技术支持解决问题。

INVALID_CONTRACTF合约中的参数值与当前交易中的参数值不匹配。

检查合约中的参数值是否与当前交易中的参数值匹配。如果匹配，请联系蚂蚁集团技术支持排查问题。

KEY_NOT_FOUNDF未找到蚂蚁集团或商户的私钥或公钥。

检查私钥或公钥是否存在。如果不存在，请在蚂蚁集团开发者中心上传私钥。

MERCHANT_KYB_NOT_QUALIFIEDF由于商家的 KYB 状态，支付失败。该商户可能不符合 KYB 标准，或者 KYB 状态不符合此交易的条件。

详细原因请联系蚂蚁集团技术支持。

MERCHANT_NOT_REGISTEREDF商户未注册。

请通过注册接口注册商户。如果调用注册接口失败，请联系蚂蚁集团技术支持。

NO_INTERFACE_DEFF接口未定义。

检查 URL 是否正确。请参见接口文档中的端点。

PARAM_ILLEGALF没有传递必传参数，或者存在非法参数。例如，非数字输入、无效日期或参数的长度和类型错误。

检查并验证当前接口所需的请求字段（包括请求头字段和请求体字段）是否正确传递且有效。

SYSTEM_ERRORF发生系统错误。

请勿重试，请联系蚂蚁集团技术支持了解更多详情。

REQUEST_TRAFFIC_EXCEED_LIMITU请求流量超出限制。

再次调用该接口解决问题。若未解决，请联系蚂蚁集团技术支持。

UNKNOWN_EXCEPTIONU接口调用失败，原因未知。

再次调用接口解决问题。如仍未解决，请联系蚂蚁集团技术支持。