---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/subscription/invoice/receiptQuery/index.md
description: >-
  The Receipt Details API queries a payment receipt by receipt ID, returning the
  payment status, amount, transaction number and refund records.
---
# Receipt Details

```apidef
endpoint: POST /v4/invoices/receipt/query
name: Receipt Details
summary: Query payment receipt details by receiptId
tags: Invoice, Receipt
```

The Receipt Details API queries a payment receipt by receipt ID, returning the payment status, amount, transaction number and refund records.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| clientId | string | M | Merchant ID. |
| accId | string | M | Store ID. |
| signType | string | M | Signature type, MD5; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. |
| sign | string | M | Signature value, following the V4 signature specification. All parameters participate in the signature. |
| version | string | M | API version, fixed at 4.0 . |
| bizContent | string | M | Business parameters as a JSON string. All request parameters except the common ones must be passed within this parameter. |
| └─ requestId | string | M | Unique request ID, globally unique. |
| └─ receiptId | string | M | Receipt ID. |

### Request Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "version": "4.0",
  "bizContent": "{\"requestId\":\"req_20260507_0021\",\"receiptId\":\"RCT-260507100000000001\"}"
}
```

## Response Parameters

| Parameter | Type | Description |
|--------|------|------|
| clientId | string | Merchant ID. |
| accId | string | Store ID. |
| signType | string | Signature type. |
| sign | string | Signature value, verified using the V4 signature specification. |
| code | string | Response code: 000000 on success; on failure, the business error code is passed through ( 102000 invalid parameter / 500003 resource not found / 910001 business validation failed / 910005 operation not allowed in current status / 910008 in-flight task exists / 500000 system error, etc.). |
| description | string | Response description. |
| bizContent | string | Business response as a JSON string. |
| └─ requestId | string | Unique request ID, echoed from the request. |
| └─ receiptId | string | Receipt ID. |
| └─ receiptNumber | string | Receipt number. |
| └─ invoiceId | string | Associated invoice ID. |
| └─ invoiceNumber | string | Associated invoice number. |
| └─ subscriptionDetail | object | Subscription information object, same structure as in Invoice Details: /en/notes/subscription/invoice/query/. Not returned for non-subscription scenarios. |
| └─ └─ subscriptionId | string | PingPong subscription ID. |
| └─ └─ partnerSubscriptionId | string | Merchant-side subscription ID. |
| └─ └─ startAt | string | Start of the billing period covered by this invoice, as a 10-digit second-level timestamp string. |
| └─ └─ endAt | string | End of the billing period covered by this invoice, as a 10-digit second-level timestamp string. |
| └─ status | string | Receipt status: PAID : paid.; PARTIALLY_REFUNDED : partially refunded.; FULLY_REFUNDED : fully refunded.; |
| └─ paidAt | string | Payment completion time as a 10-digit second-level timestamp string. |
| └─ amountPaid | string | Amount paid, as a decimal string. |
| └─ currency | string | Currency, ISO 4217. |
| └─ transactionId | string | PingPong transaction ID. |
| └─ merchantTransactionId | string | Merchant transaction ID. |
| └─ methodType | string | Payment method: the card brand for card payments (e.g. VISA ), or an upper-case APM name (such as PAYNOW ). |
| └─ refundRecords | array | Refund record list (array). Empty when no refund exists. |
| └─ └─ amount | string | Refund amount as a decimal string. |
| └─ └─ currency | string | Refund currency. |
| └─ └─ transactionId | string | Refund transaction ID. |
| └─ └─ merchantTransactionId | string | Merchant refund transaction ID. |
| └─ └─ refundedAt | string | Refund completion time as a 10-digit second-level timestamp string. |
| └─ download | object | File download object, same structure as download in Invoice Details: /en/notes/subscription/invoice/query/. Not returned by the details response in the current version; use the Receipt Download: /en/notes/subscription/invoice/receiptDownload/ API to obtain the download URL. |
| └─ └─ url | string | Download URL, valid for 30 days. |
| └─ └─ expiresAt | string | URL expiration time as a 10-digit second-level timestamp string. |
| └─ └─ version | integer | Invoice version that the file corresponds to. |
| └─ └─ format | string | File format, currently PDF . |

### Response Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "code": "000000",
  "description": "SUCCESS",
  "bizContent": "{\"requestId\":\"req_20260507_0021\",\"receiptId\":\"RCT-260507100000000001\",\"receiptNumber\":\"RCT-2605070001\",\"invoiceId\":\"INV-260507100000000001\",\"invoiceNumber\":\"INV-2605070001\",\"subscriptionDetail\":{\"subscriptionId\":\"SUB-2605070001\",\"partnerSubscriptionId\":\"sub_20260507_0002\",\"startAt\":\"2026-05-07T00:00:00Z\",\"endAt\":\"2026-06-07T00:00:00Z\"},\"status\":\"PAID\",\"paidAt\":\"2026-05-07T00:02:00Z\",\"amountPaid\":\"10.00\",\"currency\":\"USD\",\"transactionId\":\"260507100000000001\",\"merchantTransactionId\":\"M202605070001\",\"methodType\":\"CARD\",\"refundRecords\":[],\"download\":{\"url\":\"https://example.com/receipt/RCT-2605070001.pdf\",\"expiresAt\":\"2026-06-06T00:00:00Z\",\"version\":1,\"format\":\"PDF\"}}"
}
```