---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/paymentQuery/index.md
description: >-
  单笔交易查询API用于获取特定交易的详细信息。适用于需要追踪或验证某一笔支付状态的情况，支持通过交易ID来调用。主要功能包括返回交易状态、金额及时间等关键数据。
---
# 单笔交易查询

```apidef
endpoint: POST /onsiteAcquirer/payment/query
name: 单笔交易查询
```

单笔交易查询API用于获取特定交易的详细信息。适用于需要追踪或验证某一笔支付状态的情况，支持通过交易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 | M | 唯一请求号，全局唯一 |
| └─ requestTime | string | M | 商户侧请求时间。时间戳，到毫秒 |
| └─ transactionId | string | M | PingPong 交易流水号，与 merchantTransactionId 至少上送一项 |
| └─ merchantTransactionId | string | M | 商户网站交易流水号，与 transactionId 至少上送一项 |

### 请求示例

```json
{
  "accId": "2018092520455210043243",
  "bizContent": "{\"requestId\":\"REQ-E5RE2UOSN71748594003057\",\"requestTime\":\"1748594003057\",\"transactionId\":\"OS202505300010000201\"}",
  "clientId": "2018092520455210043",
  "sign": "D861DA5DDA33FF09B2935C3473A177B74545B450F34334626D979AB266C75BAB",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| 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 | 商户网站的的交易流水号 |
| └─ currency | string | 交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ amount | string | 交易金额，精确位数和币种有关，请查询附录交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ transactionTime | string | 交易发起时间，时间戳 |
| └─ status | string | 交易状态：状态幂等: /notes/zh/guide/paystatus/ INIT-初始态; IPROCESSING-进行中; SUCCESS-成功; FAILED-失败; AUTH_SUCCESS-预授权成功; CANCEL-预授权撤销; CLOSED-订单关闭; |
| └─ transactionEndingTime | string | 交易到达终态时间，时间戳 |
| └─ remark | string | 商户扩展字段，可用于指定特定参数，会在响应体中原样返回 |
| └─ resultCode | string | 状态结果码 |
| └─ resultDescription | string | 状态结果描述 |
| └─ cardTransinfo | object | 卡支付信息 |
| └─ └─ acqBankName | string | POS刷卡交易收单行银行名称 |
| └─ └─ acqTermnialId | string | POS刷卡交易收单行交易终端号 |
| └─ └─ acqMerchantId | string | POS刷卡交易收单行商户号 |
| └─ └─ acqRRN | string | POS刷卡交易收单行RRN |
| └─ └─ acqStan | string | POS刷卡交易收单行终端流水号 |
| └─ └─ acqRspCode | string | POS刷卡交易收单行交易返回码 |
| └─ └─ acqRspMessage | string | POS刷卡交易收单行交易返回码解释 |
| └─ └─ acqBatchNumber | string | POS刷卡交易收单行交易批次号 |
| └─ └─ acqInvoiceNumber | string | POS刷卡交易收单行交易InvoiceNumber |
| └─ └─ desensitizedCardNo | string | POS刷卡交易收单行交易卡号需要前六后四脱敏显示 |
| └─ └─ issuerBankName | string | POS刷卡交易收单行交易卡发卡行名称 |
| └─ └─ cardHolderName | string | POS刷卡交易收单行交易卡持卡人姓名 |

### 响应示例

```json
{
  "accId": "2018092520455210043243",
  "bizContent": "{\"amount\":\"121.23\",\"remark\":\"payment test\",\"transactionTime\":\"1748591388000\",\"transactionId\":\"OS202505300010000201\",\"merchantTransactionId\":\"PMT-15ZSIRMPKT1748591387687\",\"currency\":\"MYR\",\"status\":\"PROCESSING\"}",
  "clientId": "2018092520455210043",
  "code": "001000",
  "description": "Successful request"
}
```