Request Body Parameters

application/json

公共请求参数

bizContent

• paymentMethodObject必填
• threeDSRequestDataString按条件选
• 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可选
• 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"
}

下一页绑卡查询接口