---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/subscription/invoice/receiptDownload/index.md
description: >-
  The Receipt Download API generates and returns the payment receipt PDF
  download link, valid for 30 days, together with the associated invoice
  information and file version number.
---
# Receipt Download

```apidef
endpoint: POST /v4/invoices/receipt/download
name: Receipt Download
summary: Generate the payment receipt PDF download link
tags: Invoice, Receipt
```

The Receipt Download API generates and returns the payment receipt PDF download link, valid for 30 days, together with the associated invoice information and file version number.

## 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_0022\",\"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. |
| └─ version | integer | Invoice version that the file corresponds to. |
| └─ format | string | File format, currently PDF . |
| └─ downloadUrl | string | Download URL, valid for 30 days. |
| └─ downloadUrlExpiresAt | string | URL expiration time as a 10-digit second-level timestamp string. |

### Response Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "code": "000000",
  "description": "SUCCESS",
  "bizContent": "{\"requestId\":\"req_20260507_0022\",\"receiptId\":\"RCT-260507100000000001\",\"receiptNumber\":\"RCT-2605070001\",\"invoiceId\":\"INV-260507100000000001\",\"invoiceNumber\":\"INV-2605070001\",\"version\":1,\"format\":\"PDF\",\"downloadUrl\":\"https://example.com/receipt/RCT-2605070001.pdf\",\"downloadUrlExpiresAt\":\"2026-06-06T00:00:00Z\"}"
}
```