---
url: 'https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/risk/3ds/index.md'
description: 说明 Dynamic 3D Secure 的接入方式和风控决策逻辑,覆盖 Frictionless、Challenge 和认证结果处理。
---
3D Secure是一种安全协议,用于验证在线交易并防止电子商务中的欺诈活动。它要求持卡人在完成交易前输入密码或一次性代码,从而为支付过程增加了额外的安全层。
当您的网站或移动应用程序支持3D Secure时,发送支付的请求PingPongCheckout将确定是否通过3D 安全认证支付。
## 3D Secure 认证流程
### Frictionless
在Frictionless 流程中,购买者、发行者和卡方案通过使用购物者的设备指纹的被动认证在后台交换所有必要的信息。事务在没有进一步的购物者交互的情况下完成。
### Challenge
在Challenge 流程中,银行或支付处理机构会自动为持卡人创建一个3D挑战页,购物者需要进行额外的交互。发卡行通过生物特征识别、双因素身份验证,或者基于 SCA 身份验证因素等类似方法确保交易的安全性。
一旦卡片持有人完成了3D挑战页上的身份验证步骤,他们的身份将被验证,并且银行或支付处理机构可以决定是否批准该交易。
## 默认的3D 安全规则
一般的,PingPongCheckout提供默认的3D 安全规则,PingPongCheckout风控引擎将决定当前交易是否需要启用3DS认证。
| 策略 | 描述 | 3DS 组件集成 | 额外要求 |
|:----:|:--------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------:|
| 笔笔3D | 3D Secure 始终启用 |

| |
| 智能决策 | 根据持卡人行为特征智能决策 | | customer.email |
## 商户自主决策
如果PingPong提供的默认规则不能满足您自定义需求,PingPongCheckout提供了商户自主决策的能力。
您可以根据自己的业务场景,在API中通过`executeThreeD`参数决定是否启用3DS认证。
::: danger 注意
是否能开通需根据商户风险情况和拒付表现进行评估,需要的话可以联系技术支持开通配置。
:::
| executeThreeD | 收银台支持 | 端到端模式支持 | 描述 |
|:--------------|:--------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------|:------------------------------------------------|
| Y | 
| 
| 强制进行3ds验证,并且使用PingPongCheckout的3ds。 |
| depends | 
| 
| 是否进行3ds验证交由PingPongCheckout的风控决策决定 |
| external | 
| 
| 需要进行3ds验证,在商户执行3ds,并把3ds结果交由PingPongCheckout执行。 |
## 3DS集成方案
### 3DS服务集成
如果您尚未接入3DS服务,可以使用PingPongCheckout提供的3DS服务。PingPongCheckout提供了以下集成方案:
| 集成方案 | Hosted是否需要集成 | Non-Hosted是否需要集成 | 风控 | 3DS | 备注 |
|:-----------------|:--------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------|:---------------------------------------------------------------------------------|:-----------------------------------------------------------------------------|-----------|
| SafePayGuardJs组件 | 
| 
| 
| 
| 可集成 |
| RiskDefense组件 | 
| 
| 
| 
| 不推荐,方案已移除 |
| SecureShieldJs组件 | 
| 
| 
| 
| 可集成 |
| Server To Server | 
| 
| 
| 
| 可集成 |
## 商户自行上送 3DS 结果
如果您已经接入3DS服务,并且能够自主产生3DS结果,您可以选择商户自行上送3DS结果。

### 3DS关键入参
| 字段名称 | 类型 | 描述 |
|------------------------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| executeThreeD | String | 主动上送3DS结果填`external` |
| authenticationValue | String | 发卡行在客户身份验证后为Visa、American Express、JCB、Diners Club和Discover交易生成的唯一标识符。原始数据以base64为单位。需要将值转换为可读格式。 |
| acsTransactionId | String | 由ACS分配的唯一事务标识符,用于标识单个事务。 |
| veresEnrolled | String | 注册检查的结果。此字段可以包含以下值之一:- Y: 卡已注册或可注册;您必须进行身份验证。责任转移。- N: 未登记卡;进行授权。责任转移。- U: 无论何种原因,都无法进行身份验证。没有责任转移。 |
| specificationVersion | String | 此字段包含用于处理事务的3D Secure版本。例如,1.0.2或2.0.0。 |
| directoryServerTransactionId | String | 目录服务器交易ID由万事达目录服务器在认证交易期间生成,并与认证结果一起传递回商家。 |
| threeDSServerTransactionId | String | 3DS服务器分配的唯一事务标识符,用于标识单个事务。 |
| paresStatus | String | 身份验证检查的原始结果。此字段可以包含以下值之一:- A: 已生成身份验证尝试的证明。- N: 客户身份验证失败或取消。交易被拒绝。- U: 无论何种原因,身份验证都未完成。- Y: 客户已成功通过身份验证。 |
| eci | String | 对于验证,仅为Visa、American Express、JCB返回数字电子商务指示符(ECI)Diners Club和Discover交易。身份验证失败时缺少字段。此字段包含以下值之一:- 01: 尝试身份验证(万事达卡)- 02: 认证成功(万事达卡)- 05: 成功的身份验证(Visa,American Express,JCB,Diners Club和Discover)- 06: 尝试身份验证(Visa,American Express,JCB,Diners Club和Discover) |
### 下单并支付接口入参示例
```json
{
"clientId": "2018092714313010016",
"accId": "2018092714313010016431",
"amount": 10,
"version": "1.0",
"currency": "USD",
"merchantTransactionId": "{{merchantTransactionId}}",
"paymentType": "SALE",
"shopperResultUrl": "https://aa.com",
"shopperCancelUrl": "https://aa.com",
"signType": "MD5",
"threeDSecure": "N",
"sign": "{{Sign}}",
"requestId": "{{requestId}}",
"acquirerType": "PAY",
"notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
"threeDSRequestData": {
"executeThreeD": "external",
"acsTransactionId": "d53e5ae3-6a98-4ae0-be1a-7e7f0e91f392",
"authenticationValue": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=",
"directoryServerTransactionId": "83196474-07ec-43d5-85a0-aafc9e505419",
"eci": "02",
"paresStatus": "Y",
"threeDSServerTransactionId": "59a87425-2e29-484e-94f8-f2bc04649332",
"specificationVersion": "2.1.0"
},
"payMethodInfo": {
"card": {
"cvv": "103",
"expireMonth": "12",
"expireYear": "2025",
"holderFirstName": "James",
"holderLastName": "LeBron",
"number": "5200000000003092"
}
},
"billing": {
"city": "Birmingham",
"country": "US",
"email": "3ds@pingpongx.com",
"firstName": "James",
"lastName": "LeBron",
"phone": "18301770495",
"postcode": "35222",
"state": "AL",
"street": "1986 Broad Street"
},
"shipping": {
"city": "Miami",
"country": "US",
"email": "t_email",
"firstName": "Jamesbb",
"lastName": "LeBronbb",
"phone": "3055787342",
"postcode": "33131",
"state": "FL",
"street": "701 Brickell Avenue, Suite 2700",
"lastModifierStreetTime": "20191225162010",
"lastModifierPhoneTime": "20191225162010"
},
"customer": {
"acquisitionChannel": "SEARCH_ENGINE",
"customerId": "20191201001",
"domain": "pingpongx.com",
"email": "3ds@pingpongx.com",
"firstName": "James",
"firstOrder": "N",
"identificationId": "",
"identificationType": "ID",
"lastName": "LeBron",
"lastPayTime": "201905120330",
"loginIp": "222.126.52.24",
"loginTime": "201912010032",
"middleName": "von",
"nonMemberOrder": "N",
"orderCountry": "US",
"orderIp": "222.126.52.23",
"orderTime": "20191201001",
"payCountry": "US",
"payIp": "222.126.52.25",
"phone": "18301770495"
}
}
```