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) |
# 统一下单接口入参示例
{
"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
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
上次更新: 2023/07/04, 14:48:33