--- url: >- https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/threeDS/3DSexternal/index.md description: >- 3DS external接口用于商户主动上送3DS验证结果处理流程。适用于需要对持卡人进行额外身份验证的在线支付场景，支持Visa、American Express等主要卡组织。关键参数包括executeThreeD（固定值external）、authenticationValue（发卡行生成的身份 --- ## 商户主动上送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" } } ```