商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4 (opens new window)
  • V4-English (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4 (opens new window)
  • V4-English (opens new window)
  • 接入指南

    • 起步
    • 名词约定
    • 对接流程(必读)
    • 沙箱环境测试资源
    • 对接验收
    • 签名规约
  • 接入方案

    • 收银台模式

      • 内嵌JS-SDK
      • 跳转接入
    • 端到端模式

      • 快速开始
      • 商户收银台规范
    • 交易状态

      • 交易状态
      • 风险订单REVIEW
      • 异步通知
    • 交易场景

      • 交易模式-DEBIT和AUTH
      • Tokenization
      • NetworkToken
      • 本地支付
      • 3D集成指南
      • recurring集成指南
      • 退款集成指南
      • dispute API集成指南
      • 一键支付集成指南
    • 开源建站工具插件支持

      • Magento235
      • Woocommerce
      • OpenCart
      • Prestashop
      • ZenCart
  • APIs

    • 交易下单

      • 获取跳转收银台
      • 收银台SDK参数
      • 端到端直连-仅信用卡
      • 统一下单-本地支付&信用卡
      • 退款
      • 预授权确认
      • 预授权取消
      • 修改交易信息
    • 交易查询

    • 快捷支付

    • 一键支付

    • 拒付管理

    • 风控管理

    • 物流信息

    • 交易账单

    • 币种汇率

    • 商户信息

    • KYB方案

  • 工具

  • 附录

  • v3

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
上次更新: 2023/07/04, 14:48:33
杭州乒乓智能技术有限公司 | Copyright © 2015-2024 checkout.pingpongx.com.All Rights Reserved.
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式