Request Body Parameters

application/json

公共请求参数

bizContent

• requestIdString可选

  支付请求流水号；来源于交易异步通知，API Only 接口请求入参的requestId；作用是查询requestId对应的那笔交易信息
• transactionIdString按条件选

  PingPong 交易流水号，与 merchantTransactionId 至少上送一项
• merchantTransactionIdString按条件选

  商户网站交易流水号，与 transactionId 至少上送一项

请求报文示例

{
  "accId": "2018092714313010016291",
  "clientId": "2018092714313010016",
  "signType": "SHA256",
  "sign": "898A3CBE981B3E2BF4E2B8D1A817D7E23EF93BC4293993EE545E36F4C87F2E79",
  "version": "1.0",
  "bizContent": {
    "transactionId": "2023070750000647"
  }
}

Responses Body Parameters

application/json

公共返回参数

bizContent

• issuerInfoObject可选
• paymentMethodObject可选
• cardInfoObject可选
• threeDSInfoObject可选
• authenticationInfoObject可选
• transactionIdString必填

  PingPong 交易流水号
• merchantTransactionIdString(64)必填

  网站交易流水号
• captureDelayHoursint按条件选

  • 0表示立即capture
  • -1表示手动capture，调用统一下单API成功之后还需要调用下预授权请款 ,本地支付不支持
• currencyString(3)必填

  交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种
• amountString(12)必填

  交易金额，精确位数和币种有关，请查询附录交易币种
• transactionTimeString(64)必填

  交易发起时间，时间戳
• transactionEndingTimeString(64)必填

  交易到达终态时间，时间戳
• statusString(32)必填

  交易状态：状态幂等
• INIT-初始态
• PROCESSING-进行中
• SUCCESS-成功
• FAILED-失败
• AUTH_SUCCESS-预授权成功
• CANCEL-预授权撤销/人工审核拒绝
• CLOSED-订单关闭

remarkString(255)可选

商户扩展字段，可用于指定特定参数，会在响应体中原样返回

payResultUrlString(255)按条件选

商户自定义接收重定向的结果URL;3DS验证，银行在线转账或虚拟钱包之类支付方式时，最后需要重定向到商户指定的⻚面地址

tokenString(64)按条件选

保存卡成功后返回的支付凭证，可用于后续基于 token 的支付场景。若首笔交易按 `CardOnFile` 交易模式处理，后续使用该 token 支付时也需继续传 `bizType=CardOnFile`。详见接入概览与方案选择

threeDContinueString(32)按条件选

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

• true:是
• false:否

threeDUnionParamsObject按条件选

3DS 验证参数集合，当交易需要 3DS 验证处理的时 候，将该参数的返回值传入 PingPong 提供的插件 js指定的函数中(使用⻛控插件对接的商户使用)

exchangedAmountString可选

换汇金额

exchangedCurrencyString可选

换汇币种

requestIdString(64)必填

唯一请求号，全局唯一

resultCodeString(6)按条件选

状态结果码

resultDescriptionString(500)按条件选

状态结果描述

请求报文示例

{
  "accId": "2023060217493010231446",
  "bizContent": {
    "issuerInfo": {
      "issuerResultMsg": "Successful approval/completion or V .I.P .PIN\n verification is successful",
      "issuerResultCode": "00"
    },
    "threeDSecure": "",
    "resultCode": "000000",
    "transactionTime": "1693290395000",
    "requestId": "PMT-QNS10ZZ7O91693290394921",
    "merchantTransactionId": "PMT-QNS10ZZ7O91693290394921",
    "currency": "USD",
    "resultDescription": "Transaction succeeded",
    "amount": "200.000000",
    "authenticationInfo": {
      "avsResult": "Unknown",
      "cvvResult": "Y",
      "threeDSecure": "N"
    },
    "cardInfo": {
      "firstName": "James",
      "isoCountryA2": "RU",
      "lastName": "LeBron",
      "lastFourDigits": "1112",
      "cardLevel": "CLASSIC",
      "paymentBrand": "VISA",
      "cardType": "CREDIT",
      "issuringBank": "",
      "ipCountry": "HK",
      "firstSixDigits": "401200",
      "isoCountry": "RUSSIAN FEDERATION"
    },
    "transactionId": "2023082950003030",
    "token": "h3cov3regCvMuuQWbY",
    "captureDelayHours": 0,
    "status": "SUCCESS"
  },
  "clientId": "2023060217493010231",
  "code": "001000",
  "description": "Successful request",
  "sign": "940E744960C32C1040F831FEFD87258EEAD257784861E8EC8860489162AAD3E3",
  "signType": "SHA256"
}