decide
当买家在您的客户端支付时，使用该接口向蚂蚁集团请求有关是否接受该交易的实时风控建议。该接口在卡支付授权前后均可调用。
结构
报文由报文头和报文体构成，下文主要介绍报文体结构。
注意：将每个字段的数据类型设置为 String （数组类型的字段除外） 。这意味着您必须使用双引号 (" ") 将字段值括起来。例如：
- 如果某个字段的数据类型为 Integer 且值为 20，则将其设置为 “20”。
- 如果某个字段的数据类型为 Boolean 且值为 true，则将其设置为 “true ”。
Request parameters
referenceTransactionId String REQUIRED
直接向买家提供服务或商品的商户分配的唯一ID，用于识别交易。
More information:
- Maximum length: 64 characters
authorizationPhase String REQUIRED
调用 API 的时间。有效值为：
PRE_AUTHORIZATION：表示您在卡支付授权之前发起此请求。- POST_AUTHORIZATION ：表示您在卡支付授权后发起此请求。
More information:
- Maximum length: 16 characters
orders Array<Order> object REQUIRED
订单信息，例如商户、商品、金额和运输信息。
More information:
- Maximum size: 10 elements
buyer Buyer object REQUIRED
买家信息，包括买家的 ID、姓名、电话号码和电子邮件。
actualPaymentAmount Amount object REQUIRED
指扣除折扣后买家实际需要支付的金额。
paymentDetails Array<PaymentDetail> object REQUIRED
支付方式详细信息，包括支付方式类型、卡信息等。
More information:
- Maximum size: 5 elements
discountAmount Amount object
本次交易的折扣金额。
提供这些信息有助于提升欺诈检测的准确性，提高支付成功率。
env Env object REQUIRED
下单环境信息，例如设备信息。
Response parameters
decision string REQUIRED
蚂蚁集团的风控决策。有效值为：
ACCEPT：表示建议接受该笔支付。REJECT：表示建议拒绝该笔支付。
More information:
- Maximum length: 16 characters
authenticationDecision String
蚂蚁集团推荐的身份验证方法。有效值为：
3D：本次交易建议使用 3D 认证。NON_3D：本次交易建议使用非 3D 认证。
当 decision 的值为 ACCEPT 时，返回该参数。
More information:
- Maximum length: 16 characters
result Result object REQUIRED
接口调用的结果。
Request
Response
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 | 接口调用失败，原因未知。 | 再次调用接口解决问题。如仍未解决，请联系蚂蚁集团技术支持。 |