3DS external

# 商户主动上送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）

# 下单并支付接口入参示例

{
    "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"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

// Make sure to add code blocks to your code group

上次更新: 2024/04/17, 16:23:53