Antom 3DS-Retry

2026-02-11 09:44

Antom 的 3DS-Retry 功能可智能、自动地处理因未完成 3DS 认证等原因被软拒绝的交易。该功能通过内置策略，在适当时机自动为符合条件的交易重新发起 3DS 认证，从而有效挽回支付机会，提升整体成交率。无论您在初始请求中是否选择 3DS 认证，均可用此功能恢复需认证的交易，降低因认证缺失导致的交易拒绝风险。

您只需在发起交易时将 enableAuthenticationUpgrade 参数设为

true

，即可启用 Antom 3DS-Retry 功能。若不启用该功能，当交易的卡种强制要求 3DS 认证而您的交易未进行时，卡组织可能视其为高风险交易并直接拒绝。启用后，Antom 将自动尝试恢复此类交易，无需您进行额外处理。

注意：仅支持 3D Secure 2 认证的卡可使用 Antom 3DS-Retry 功能。

设置 3DS 认证和 Antom 3DS-Retry 功能将共同决定交易最终是否进行 3DS 认证。下表展示了这两个功能的设置对交易的影响：


设置 3DS 认证： is3DSAuthentication	设置 Antom 3DS-Retry： enableAuthenticationUpgrade	交易最终是否进行 3DS 认证
false /留空	true /留空	发起非 3DS 交易后，若交易因未完成 3DS 认证等原因被软拒绝，Antom 自动将交易升级成 3DS 交易并重试支付。
false /留空	false	发起非 3DS 交易，若交易失败，Antom 直接向您返回失败结果，不会重试。
true	true / false /留空	始终发起 3DS 交易。

支付流程

以下图片展示了启用 Antom 3DS-Retry 功能的支付流程：

商户端提交支付请求。
当支付因未完成 3DS 认证等原因被软拒绝时，Antom 3DS-Retry 会进行智能决策并重试支付。
如果 Antom 自动重试成功，将向您返回支付成功结果。

如何启用

Payment Element 集成

在调用 createPaymentSession（单笔支付）接口时，将 availablePaymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 参数设为

true

或保留默认值，以启用 Antom 3DS-Retry 功能。

{
...
"availablePaymentMethod": {
  "paymentMethodMetaData": {
    "enableAuthenticationUpgrade": true
  }
},  
...
}

Checkout Page (CKP) 集成

在调用 createPaymentSession（单笔支付）接口时，将 availablePaymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 参数设为

true

或保留默认值，以启用 Antom 3DS-Retry 功能。

{
...
"availablePaymentMethod": {
  "paymentMethodMetaData": {
    "enableAuthenticationUpgrade": true
  }
},  
...
}

托管式卡支付集成

在调用 pay（单笔支付）接口时，将 paymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 参数设置为

true

或保留默认值，以启用 Antom 3DS-Retry 功能。

{
...
"paymentMethod": {
  "paymentMethodMetaData": {
    "enableAuthenticationUpgrade": true
  }
},  
...
}

注意：Antom 3DS-Retry 功能开启后，如果您将 is3DSAuthentication 参数设为

false

或保留默认值（即指定交易为非 3DS 交易），在绑卡支付场景下，pay（单笔支付）接口会返回 normalUrl 所对应的卡信息输入页。在此配置下，即便已指定交易为非 3DS 交易，若买家提交支付后发卡行拒绝该交易，则仍可能跳转至 3DS URL 进行验证，而不会直接返回最终交易结果（成功或失败）。此时如需关闭 Antom 3DS-Retry 功能，请将 paymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 设为

false

，示例代码如下：

{
...
"paymentMethod": {
  "paymentMethodMetaData": {
    "is3DSAuthentication": false,
    "enableAuthenticationUpgrade": false
  }
},  
...
}

服务端-服务端式卡支付集成

在调用 pay（单笔支付）接口时，将 paymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 参数设置为

true

或保留默认值，以启用 Antom 3DS-Retry 功能。

{
...
"paymentMethod": {
  "paymentMethodMetaData": {
    "cvv": "111",
    "expiryMonth": "12",
    "expiryYear": "29",
    "cardNo": "49************75",
    "enableAuthenticationUpgrade": true
  }
},  
...
}

注意：Antom 3DS-Retry 功能开启后，如果您将 is3DSAuthentication 参数设为

false

或保留默认值（即指定交易为非 3DS 交易），pay（单笔支付）接口可能会返回 normalUrl 并需要买家跳转 3DS URL 进行验证，而非直接返回最终交易结果（成功或失败）。此时如需关闭 Antom 3DS-Retry 功能，请将 paymentMethod.paymentMethodMetaData.enableAuthenticationUpgrade 设为

false

，示例代码如下：

{
...
"paymentMethod": {
  "paymentMethodMetaData": {
    "is3DSAuthentication": false,
    "enableAuthenticationUpgrade": false
  }
},  
...
}