---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/gmc/payQuery/index.md
description: >-
  GMC串口交易查询接口用于查询支付交易的状态和详情。通过串口与POS设备通信,支持按商户订单号或PingPong交易流水号查询交易状态、金额、时间等详细信息。采用SHA256签名保证数据安全,适用于对账、状态确认等场景。
---
# GMC串口交易查询接口

```apidef
endpoint: POST /onsiteAcquirer/gmc/payQuery
name: GMC串口交易查询接口
```

GMC串口交易查询接口用于查询支付交易的状态和详情。通过串口与POS设备通信,支持按商户订单号或PingPong交易流水号查询交易状态、金额、时间等详细信息。采用SHA256签名保证数据安全,适用于对账、状态确认等场景。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 商户在PingPong系统的店铺唯一标识 |
| clientId | string | M | PingPong商户号 |
| signType | string | M | 签名类型,支持 SHA256 |
| sign | string | M | 请求签名,所有参数均参与签名,具体见签名规约: /notes/zh/onlinePayment/developer/sign/ |
| version | string | M | 协议版本,当前为 1.0 |
| event | string | M | 事件类型,枚举值: PAY - 支付; REFUND - 退款; QUERY - 查询; HEARTBEAT - 心跳检测; REPRINT - 重打印; CALCULATE - 结算; |
| requestTime | string | M | 请求时间戳(毫秒) |
| bizContent | string | M | 业务参数JSON字符串,除公共请求参数外所有请求参数都必须放在这个参数中传递。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantTransactionId | string | C | 商户交易流水号,与 transactionId 二选一 |
| └─ transactionId | string | C | PingPong交易流水号,与 merchantTransactionId 二选一 |

### 请求示例

```json
{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "PAY_QUERY",
  "requestTime": "1683532500000",
  "bizContent": "{\"merchantTransactionId\":\"MCH_ORDER_20231212001\"}"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| 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。 |
| └─ requestId | string | 唯一请求号 |
| └─ merchantTransactionId | string | 商户网站的交易流水号 |
| └─ transactionId | string | PingPong交易流水号 |
| └─ amount | string | 交易金额,精确位数和币种有关,详见交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ currency | string | 交易币种,ISO 4217三位币种代码,详见交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ transactionTime | string | 交易发起时间,时间戳(毫秒) |
| └─ status | string | 交易状态: PROCESSING - 进行中; SUCCESS - 成功; FAILED - 失败; |
| └─ transactionEndingTime | string | 交易到达终态时间,时间戳(毫秒) |
| └─ remark | string | 商户扩展字段,可用于指定特定参数,会在响应体中原样返回 |
| └─ cardTransinfo | object | 卡支付信息,仅卡支付返回 |
| └─ └─ acqBankName | string | POS刷卡交易收单行银行名称 |
| └─ └─ acqTermnialId | string | POS刷卡交易收单行交易终端号 |
| └─ └─ acqMerchantId | string | POS刷卡交易收单行商户号 |
| └─ └─ acqRRN | string | POS刷卡交易收单行RRN(Retrieval Reference Number) |
| └─ └─ 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": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "PAY_QUERY",
  "code": "000000",
  "description": "查询成功",
  "requestTime": "1683532501000",
  "bizContent": "{\"requestId\":\"REQ_202312120001\",\"merchantTransactionId\":\"MCH_ORDER_20231212001\",\"transactionId\":\"PPX_TXN_202312120001\",\"amount\":\"100.00\",\"currency\":\"USD\",\"transactionTime\":\"1683530496000\",\"status\":\"SUCCESS\",\"transactionEndingTime\":\"1683530496900\",\"remark\":\"测试订单\",\"cardTransinfo\":{\"acqBankName\":\"Bank of America\",\"acqTermnialId\":\"TERM001\",\"acqMerchantId\":\"MCHNT001\",\"acqRRN\":\"RRN001\",\"acqStan\":\"STAN001\",\"acqRspCode\":\"00\",\"acqRspMessage\":\"Approved\",\"acqBatchNumber\":\"BATCH001\",\"acqInvoiceNumber\":\"INV001\",\"desensitizedCardNo\":\"123456******1234\",\"issuerBankName\":\"Bank of America\",\"cardHolderName\":\"John Doe\"}}"
}
```