单笔交易查询

约 216 字小于 1 分钟

View as Markdown

2025-03-07

POST

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

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可选
银行返回信息
- issuerResultCodeString可选
  银行返回编码
- issuerResultMsgString可选
  银行返回信息描述
- issuerNameString按条件选
  发卡行名称，仅Qris支付成功后按渠道能力返回
paymentMethodObject可选
要使用的付款方式的类型和所需的详细信息。
- typeString(32)必填
  付款方式：
  scheme 国际信用卡支付
  本地支付方式可选值：Non-Hosted支持的APM
- subTypeString(32)可选
  Klarna订单对应产品类型:
  Pay Now
  Pay In Part
cardInfoObject可选
支付信用卡信息
- cardLevelString(32)必填
  卡交易·卡级别
- cardTypeString必填
  卡交易·卡类型,枚举值：
  DEBIT
  CREDIT
  CHARGE
  CARD
- firstNameString必填
  持卡人名称，字符类型，不含特殊符号
- lastNameString必填
  持卡人姓，字符类型，不含特殊符号
- firstSixDigitsString(12)必填
  卡号前6位
- lastFourDigitsString(12)必填
  卡号后4位
- ipCountryString(4)必填
  用户交易国家
- isoCountryString必填
  发卡行国家
- issuringBankString必填
  发卡行
- isoCountryA2String按条件选
  国家二字码，符合iso3166标准
- paymentBrandString必填
  卡交易·卡品牌：VISA / Mastercard / American Express/ JCB / Discover
threeDSInfoObject可选
3ds参数
- cavvString可选
  cavv
- authenticationResultString可选
  3DS验证结果，枚举值如下:
  Y：验证通过
  A: 持卡人未参与，但尝试进行身份验证的记录已被录入
  N：验证失败
- liabilityShiftString可选
  责任转移
- eciString可选
  仅对 Visa、American Express、ICB、Diners Club 和Discover 的交易才会返回。当身份验证失败时，该字段为空。该字段包含以下值之一:
  01:尝试身份验证 (Mastercard) 01:
  02:成功身份验证 (Mastercard)
  05:成功身份验证 (Visa、American Express、JCB、Diners Club 和 Discover)
  06: 尝试身份验证 (Visa、American Express、JCB、Diners Club 和 Discover)
- authentication3DSecureString必填
  threeDSServerTransactionId / directoryServerTransactionId 不为空
- specificationVersionString必填
  3DS版本
authenticationInfoObject可选
身份认证信息
- avsResultString可选
  枚举值如下：
  Y（AVS full match）
  A（AVS street address only）
  Z（AVS postal/zip code only）
  N（AVS nonmatch）
  R（AVS indeterminate outcome (retry)）
  U（AVS unable to verify）
- cvvResultString可选
  cvv验证结果，Y/N
- threeDSecureString可选
  是否进行3DS验证，Y/N
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可选
换汇币种
payerNameString(100)按条件选
付款人名称（由发卡行决定是否返回）
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"
}

Modifications

查询API

单笔交易查询

Request Body Parameters

请求报文示例

Responses Body Parameters

请求报文示例