---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/checkout/api/getOne/index.md
description: >-
  交易查询接口用于获取特定交易的详细信息。适用于需要对已完成或正在进行中的交易进行状态跟踪和管理的场景。主要功能包括通过交易ID获取交易详情，支持的关键参数有transaction_id。
---
# 单笔交易查询

```apidef
endpoint: POST /v4/payment/query
name: 单笔交易查询
summary: 查询交易结果
tags: Query, Payment
```

交易查询接口用于获取特定交易的详细信息。适用于需要对已完成或正在进行中的交易进行状态跟踪和管理的场景。主要功能包括通过交易ID获取交易详情，支持的关键参数有transaction_id。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | O | 支付请求流水号；来源于交易异步通知，API Only 接口请求入参的requestId；作用是查询requestId对应的那笔交易信息 |
| └─ transactionId | string | C | PingPong 交易流水号，与 merchantTransactionId 至少上送一项 |
| └─ merchantTransactionId | string | C | 商户网站交易流水号，与 transactionId 至少上送一项 |

### 请求示例

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

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ transactionId | string | PingPong 交易流水号 |
| └─ merchantTransactionId | string | 网站交易流水号 |
| └─ captureDelayHours | integer | 0表示立即capture; -1表示手动capture，调用统一下单API成功之后还需要调用下预授权请款: /notes/zh/checkout/api/modifications/capture/ ,本地支付不支持; |
| └─ currency | string | 交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ amount | string | 交易金额，精确位数和币种有关，请查询附录交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ transactionTime | string | 交易发起时间，时间戳 |
| └─ transactionEndingTime | string | 交易到达终态时间，时间戳 |
| └─ status | string | 交易状态：状态幂等: /notes/zh/guide/paystatus/ INIT-初始态; PROCESSING-进行中; SUCCESS-成功; FAILED-失败; AUTH_SUCCESS-预授权成功; CANCEL-预授权撤销/人工审核拒绝; CLOSED-订单关闭; |
| └─ remark | string | 商户扩展字段，可用于指定特定参数，会在响应体中原样返回 |
| └─ payResultUrl | string | 商户自定义接收重定向的结果URL; 3DS验证，银行在线转账或虚拟钱包之类支付方式时，最后需要重定向到商户指定的⻚面地址 |
| └─ issuerInfo | object | 银行返回信息 |
| └─ └─ issuerResultCode | string | 银行返回编码 |
| └─ └─ issuerResultMsg | string | 银行返回信息描述 |
| └─ token | string | 保存卡成功后返回的支付凭证，可用于后续基于 token 的支付场景。若首笔交易按 `CardOnFile` 交易模式处理，后续使用该 token 支付时也需继续传 `bizType=CardOnFile`。详见接入概览与方案选择: /notes/zh/integrate/tokenization/cardOnFileOverview/ |
| └─ threeDContinue | string | 是否需要 3DS (验证处理使用⻛控插件对接的商户使用): true:是; false:否; |
| └─ threeDUnionParams | object | 3DS 验证参数集合，当交易需要 3DS 验证处理的时 候，将该参数的返回值传入 PingPong 提供的插件 js指定的函数中(使用⻛控插件对接的商户使用) |
| └─ exchangedAmount | string | 换汇金额 |
| └─ exchangedCurrency | string | 换汇币种 |
| └─ paymentMethod | object | 要使用的付款方式的类型和所需的详细信息。 |
| └─ └─ type | string | 付款方式： scheme 国际信用卡支付; 本地支付方式 可选值：Non-Hosted支持的APM: /notes/zh/paymentMethods/overview/; |
| └─ └─ subType | string | Klarna订单对应产品类型: Pay Now; Pay In Part; |
| └─ requestId | string | 唯一请求号，全局唯一 |
| └─ resultCode | string | 状态结果码 |
| └─ resultDescription | string | 状态结果描述 |
| └─ cardInfo | object | 支付信用卡信息 |
| └─ └─ cardLevel | string | 卡交易·卡级别 |
| └─ └─ cardType | string | 卡交易·卡类型,枚举值： DEBIT; CREDIT; CHARGE; CARD; |
| └─ └─ firstName | string | 持卡人名称，字符类型，不含特殊符号 |
| └─ └─ lastName | string | 持卡人姓，字符类型，不含特殊符号 |
| └─ └─ firstSixDigits | string | 卡号前6位 |
| └─ └─ lastFourDigits | string | 卡号后4位 |
| └─ └─ ipCountry | string | 用户交易国家 |
| └─ └─ isoCountry | string | 发卡行国家 |
| └─ └─ issuringBank | string | 发卡行 |
| └─ └─ isoCountryA2 | string | 国家二字码，符合iso3166标准 |
| └─ └─ paymentBrand | string | 卡交易·卡品牌：VISA / Mastercard / American Express/ JCB / Discover |
| └─ threeDSInfo | object | 3ds参数 |
| └─ └─ cavv | string | cavv |
| └─ └─ authenticationResult | string | 3DS验证结果，枚举值如下: Y：验证通过; A: 持卡人未参与，但尝试进行身份验证的记录已被录入; N：验证失败; |
| └─ └─ liabilityShift | string | 责任转移 |
| └─ └─ eci | string | 仅对 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); |
| └─ └─ authentication3DSecure | string | threeDSServerTransactionId / directoryServerTransactionId 不为空 |
| └─ └─ specificationVersion | string | 3DS版本 |
| └─ authenticationInfo | object | 身份认证信息 |
| └─ └─ avsResult | string | 枚举值如下： 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）; |
| └─ └─ cvvResult | string | cvv验证结果，Y/N |
| └─ └─ threeDSecure | string | 是否进行3DS验证，Y/N |

### 响应示例

```json
{
  "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"
}
```