---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/api/services/InPersonPayments/paymentQuery/index.md
description: >-
  The Single Transaction Query API is used to retrieve detailed information
  about a specific transaction. It is suitable for scenarios that require
  tracking or verifying the status of a particular payment, supporting calls
  through transaction ID. Main functions include returning key data such as
  transaction status, amount, and time.
---
# Single Transaction Query

```apidef
endpoint: POST /onsiteAcquirer/payment/query
name: Single Transaction Query
```

The Single Transaction Query API is used to retrieve detailed information about a specific transaction. It is suitable for scenarios that require tracking or verifying the status of a particular payment, supporting calls through transaction ID. Main functions include returning key data such as transaction status, amount, and time.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| accId | string | M | Unique identifier for the store, which will appear in the response message after creation; inputting it means modifying the data |
| clientId | string | M | PingPong Merchant ID |
| signType | string | M | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document |
| sign | string | M | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature |
| version | string | M | Version number, currently fixed at 1.0, may be adjusted with changes to the interface in the future |
| bizContent | string | M | Collection of request parameters, with no limit on maximum length. Except for common request parameters, all other request parameters must be passed within this parameter, format: JSON string |
| └─ requestId | string | M | Unique request number, globally unique |
| └─ requestTime | string | M | Merchant-side request time. Timestamp, to the millisecond |
| └─ transactionId | string | M | PingPong transaction ID, at least one of this or merchantTransactionId must be provided |
| └─ merchantTransactionId | string | M | Merchant website transaction ID, at least one of this or transactionId must be provided |

### Request Example

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

## Response Parameters

| Parameter | Type | Description |
|--------|------|------|
| accId | string | Unique store identifier, which will appear in the response message after being added; inputting it means modifying the data |
| clientId | string | PingPong merchant number |
| signType | string | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document |
| sign | string | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature |
| code | string | Result status code, see the appendix Status Code Table: /en/notes/appendix/successCodeList/ |
| description | string | Result description |
| bizContent | string | Business response parameters |
| └─ transactionId | string | PingPong transaction number |
| └─ merchantTransactionId | string | Merchant website's transaction number |
| └─ currency | string | Transaction currency, ISO 4217 three-letter code, see the supported currencies in the appendix Transaction Currencies: /en/notes/appendix/transactionCurrency/ |
| └─ amount | string | Transaction amount, the precision depends on the currency, please check the appendix Transaction Currencies: /en/notes/appendix/transactionCurrency/ |
| └─ transactionTime | string | Time when the transaction was initiated, timestamp |
| └─ status | string | Transaction status: Idempotent Status: /notes/zh/guide/paystatus/ INIT - Initial state; IPROCESSING - In progress; SUCCESS - Success; FAILED - Failed; AUTH_SUCCESS - Pre-authorization success; CANCEL - Pre-authorization canceled; CLOSED - Order closed; |
| └─ transactionEndingTime | string | Time when the transaction reached its final state, timestamp |
| └─ remark | string | Merchant extended fields, can be used to specify certain parameters, will be returned as is in the response body |
| └─ resultCode | string | Status result code |
| └─ resultDescription | string | Description of the status result |
| └─ cardTransinfo | object | Card payment information |
| └─ └─ acqBankName | string | Name of the acquiring bank for POS card transactions |
| └─ └─ acqTermnialId | string | Terminal number of the acquiring bank for POS card transactions |
| └─ └─ acqMerchantId | string | Merchant number of the acquiring bank for POS card transactions |
| └─ └─ acqRRN | string | RRN (Retrieval Reference Number) of the acquiring bank for POS card transactions |
| └─ └─ acqStan | string | Terminal transaction number of the acquiring bank for POS card transactions |
| └─ └─ acqRspCode | string | Response code of the acquiring bank for POS card transactions |
| └─ └─ acqRspMessage | string | Explanation of the response code of the acquiring bank for POS card transactions |
| └─ └─ acqBatchNumber | string | Batch number of the acquiring bank for POS card transactions |
| └─ └─ acqInvoiceNumber | string | Invoice Number of the acquiring bank for POS card transactions |
| └─ └─ desensitizedCardNo | string | Card number for POS card transactions, display with the first six and last four digits visible, others masked |
| └─ └─ issuerBankName | string | Issuing bank name of the card used in POS card transactions |
| └─ └─ cardHolderName | string | Cardholder name of the card used in POS card transactions |
| └─ └─ cardType | string | Card type, enum values: DEBIT - Debit card; CREDIT - Credit card; CHARGE CARD - Charge card; |
| └─ └─ issuerBankCountry | string | Issuing bank country, ISO A2 code (ISO 3166-1 alpha-2 standard), defaults to countries supported by PingPong, see Country Codes: /en/notes/appendix/countryCode/ |
| └─ └─ cardBrand | string | Card brand, enum values: VISA; Mastercard; American Express; JCB; Discover; CHINA UNION PAY; |

### Response Example

```json
{
  "accId": "2018092520455210043243",
  "bizContent": "{\"amount\":\"121.23\",\"remark\":\"payment test\",\"transactionTime\":\"1748591388000\",\"transactionId\":\"OS202505300010000201\",\"merchantTransactionId\":\"PMT-15ZSIRMPKT1748591387687\",\"currency\":\"MYR\",\"status\":\"PROCESSING\",\"cardTransinfo\":{\"acqBankName\":\"Bank of America\",\"cardBrand\":\"VISA\",\"cardHolderName\":\"John Doe\",\"cardType\":\"CREDIT\",\"issuerBankCountry\":\"US\"}}",
  "clientId": "2018092520455210043",
  "code": "001000",
  "description": "Successful request"
}
```