POST

📍如何选择站点？请参阅 API 端点地址

Request Body Parameters

application/json

公共请求参数

bizContent

• paymentMethodObject必填

  要使用的付款方式的类型和所需的详细信息。

  • typeString(32)必填

    付款方式：

    • scheme 国际信用卡支付
    • 本地支付方式 可选值：Non-Hosted支持的APM
  • scanCodeIdString按条件选

    付款代码客户手机钱包客户端生成的支付代码。通常以条形码或QR码的形式显示。商户终端扫描客户的手机屏幕获取代码
  • cardInfoObject按条件选

    持卡人信息，信用卡支付，并且不使用绑卡情况必填

    • numberString(64)必填

      国际信用卡卡号
    • pinString(2)可选

      本地卡密码前两位
    • holderFirstNameString必填

      持卡人名，字符类型，不含特殊符号
    • holderLastNameString必填

      持卡人姓，字符类型，不含特殊符号
    • expireMonthString(2)必填

      有效期-月，2位数字
    • expireYearString(4)必填

      有效期-年，4位数字
    • cvvString(4)必填

      信用卡CVV，Visa/MasterCard/JCB/Discover/Diners club的cvv字符长度均为三位，American Express的cvv字符长度可能为四位
• threeDSRequestDataString按条件选

  3DS验证请求参数。详见3DS集成指南

  • executeThreeDString按条件选

    3ds验证执行策：

    • Y-强制进行3ds验证，并且使用PingPongCheckout的3ds
    • depends-是否进行3ds验证交由PingPongCheckout的风控决策决定
    • external-需要进行3ds验证，但3ds参数有商户自行收集，交由PingPong执行。备注：此选项不适用于收银台
  • authenticationValueString按条件选

    发卡行在客户身份验证后为Visa、American Express、JCB、Diners Club和Discover交易生成的唯一标识符。原始数据以base64为单位。需要将值转换为格式。
  • acsTransactionIdString按条件选

    由ACS分配的唯一事务标识符，用于标识单个事务。
  • veresEnrolledString按条件选

    注册检查的结果。此字段可以包含以下值之一：

    • Y-卡已注册或可注册；您必须进行身份验证。责任转移。
    • N-未登记卡；进行授权。责任转移。
    • U-无论何种原因，都无法进行身份验证。没有责任转移
  • specificationVersionString按条件选

    此字段包含用于处理事务的3D Secure版本。例如，1.0.2或2.0.0。
  • directoryServerTransactionIdString按条件选

    目录服务器交易ID由万事达目录服务器在认证交易期间生成，并与认证结果一起传递回商家。
  • threeDSServerTransactionIdString按条件选

    3DS服务器分配的唯一事务标识符，用于标识单个事务。
  • paresStatusString按条件选

    身份验证检查的原始结果。此字段可以包含以下值之一：

    • A-已生成身份验证尝试的证明。
    • N-客户身份验证失败或取消。交易被拒绝。
    • U-无论何种原因，身份验证都未完成。
    • Y-客户已成功通过身份验证。
  • eciString按条件选

    对于验证，仅为Visa、American Express、JCB返回数字电子商务指示符（ECI）Diners Club和Discover交易。身份验证失败时缺少字段。此字段包含以下值之一：

    • 01-尝试身份验证（万事达卡）
    • 02-认证成功（万事达卡）
    • 05-Successful authentication (Visa, American Express, JCB, UNION PAY, Diners Club, and Discover)
    • 06-尝试身份验证（Visa、American Express、JCB、Diners Club和Discover）
• requestIdString(64)必填

  唯一请求号，全局唯一
• merchantUserIdString(256)按条件选

  会员ID，用户在商户网站的会员ID，适用于快捷支付场景，游客身份的情况可以不传
• jsGeneratedDataString(256)按条件选

  卡支付必须接入风控组件, 卡支付需要传, 若获取失败，可传空字符串，不阻塞支付流程。通过嵌入pingpong提供的风控组件，获取浏览器相关信息的json字符串，传到这个参数中。使用⻛控插件对接的商户使用，详见3DS集成指南
• notificationUrlString(255)可选

  由商户自定义本次交易结果通知的地址，一旦填写该参数，PingPongCheckout 将通过 POST 方式异步推送交易结果到该地址。
  地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。
• languageString(12)可选

  用于指定pingpong收银台语言, 不传默认为en。详见附录收银台支持语言列表

其他参数

请求报文示例

{
  "accId": "2022102018024210348883",
  "bizContent": {
    "merchantUserId": "12604896432523150",
    "requestId": "PMT-60KLMY78TS1716979870734",
    "payResultUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
    "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
    "bizType": "CardOnFile",
    "paymentMethod": {
      "type": "scheme",
      "cardInfo": {
        "cvv": "840",
        "number": "5299910010000015",
        "expireMonth": "12",
        "expireYear": "2025"
      }
    },
    "threeDSRequestData": {
      "executeThreeD": "Y"
    },
    "browserInfo": {
      "acceptHeader": "content-type=application/x-www-form-urlencoded;accept=*/*;cache-control=no-cache;postman-token=cf489264-5378-4d5d-a86c-72c86a408c03;accept-encoding=gzip, deflate;content-length=588;connection=keep-alive;",
      "colorDepth": "32",
      "jetLag": "480",
      "screenHeight": "1980",
      "screenWidth": "1080",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 Chrome/72.0.3626.121 Safari/537.36",
      "windowSize": "05",
      "javaEnabled": "true",
      "javaScriptEnabled": "true"
    },
    "jsGeneratedData": {
      "fingerprintId": "2018092714313010016549_PP20210608151727OB",
      "forterSiteId": "e088dda90c4e",
      "forterTokenCookie": "c3402ed6f84d4c50add3458a1ce51d60_1623137756842_87_UDF43_11ck",
      "orderTerminal": "03",
      "threeDSServerTransID": ""
    },
    "customer": {
      "email": "3ds@pingpongx.com",
      "firstName": "James",
      "lastName": "LeBron",
      "identificationId": "",
      "identificationType": "ID",
      "phone": "3055787343",
      "birthDate": ""
    },
    "device": {
      "orderTerminal": "02"
    }
  },
  "clientId": "2022102018024210348",
  "sign": "C218E7E812B93FEA20FD8F16C646B3BFD36D5898FC682427CC5815C139EC1ED9",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

公共返回参数

bizContent

• threeDUnionParamsString可选

  3ds地址

  • threeDRedirectUrlString可选

    3DS跳转地址
• transactionTimeString可选

  签约时间
• transactionIdString可选

  PP签约流水号
• threeDContinueString(32)按条件选

  是否需要 3DS (验证处理使用⻛控插件对接的商户使用):

  • true:是
  • false:否
• merchantTransactionIdString可选

  商户签约单号
• statusString可选

  签约状态，如果需要做3ds，签约状态为 INIT

请求报文示例

{
  "accId": "2022102018024210348883",
  "bizContent": {
    "transactionTime": "1716979873000",
    "threeDUnionParams": {
      "threeDRedirectUrl": "https://test-acquirer-static.pingpongx.com/payment/threeDs.html?code=eyJhY3NVcmwiOiJodHRwczovL3gzZC1hbnktaW50LmNyZWRvcmF4Lm5ldC9jaGFsbGVuZ2UvcmVxdWVzdC9QSU5HUDk3OC8wZGNhYjk1NzAzYmIyMDQwOWYwOTcxZTA4ZTk1MjIzZDEyMDkiLCJ0aHJlZURTUmVzdWx0VXJsIjoibnVsbD90cmFuc2FjdGlvbklkPTIwMjQwNTI5NTAxMzkxNTUmbWVyY2hhbnRUcmFuc2FjdGlvbklkPVBNVC02MEtMTVk3OFRTMTcxNjk3OTg3MDczNCIsInJlcXVlc3RNZXRob2QiOiJHRVQiLCJjaGFubmVsIjoiQ0hBTk5FTCJ9"
    },
    "transactionId": "2024052950139155",
    "threeDContinue": "true",
    "merchantTransactionId": "PMT-60KLMY78TS1716979870734",
    "status": "INIT"
  },
  "clientId": "2022102018024210348",
  "code": "002000",
  "description": "Transaction processing",
  "sign": "2C1F98F56DB04ECEC7800E97B20D4A05153800CCD3BA52E7D3E60B49B0EB79BA",
  "signType": "SHA256"
}

下一页绑卡查询接口