---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/subscription/invoice/receiptDownload/index.md
description: 凭证下载接口生成并获取支付凭证 PDF 下载链接，链接 30 天有效，返回关联票据信息与文件版本号。
---
# 凭证下载

```apidef
endpoint: POST /v4/invoices/receipt/download
name: 凭证下载
summary: 生成并获取支付凭证 PDF 下载链接
tags: Invoice, Receipt
```

凭证下载接口生成并获取支付凭证 PDF 下载链接，链接 30 天有效，返回关联票据信息与文件版本号。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| clientId | string | M | 商户号。 |
| accId | string | M | 店铺号。 |
| signType | string | M | 签名类型，MD5，具体见本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏。 |
| sign | string | M | 签名值，沿用 V4 签名规范，所有参数均参与签名。 |
| version | string | M | 接口版本，固定为 4.0 。 |
| bizContent | string | M | 业务参数 JSON 字符串，除公共请求参数外所有请求参数都必须放在这个参数中传递。 该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | M | 唯一请求号，全局唯一。 |
| └─ receiptId | string | M | 凭证 ID。 |

### 请求示例

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

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| clientId | string | 商户号。 |
| accId | string | 店铺号。 |
| signType | string | 签名类型。 |
| sign | string | 签名值，沿用 V4 签名规范验签。 |
| code | string | 响应码：成功 000000 ；失败透传业务错误码（ 102000 参数错误 / 500003 资源不存在 / 910001 业务校验失败 / 910005 当前状态不支持该操作 / 910008 存在处理中的变更任务 / 500000 系统异常等）。 |
| description | string | 响应描述。 |
| bizContent | string | 业务响应 JSON 字符串。 该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | 唯一请求号，回显请求。 |
| └─ receiptId | string | 凭证 ID。 |
| └─ receiptNumber | string | 凭证单据号。 |
| └─ invoiceId | string | 关联票据 ID。 |
| └─ invoiceNumber | string | 关联票据单据号。 |
| └─ version | integer | 文件对应票据版本号。 |
| └─ format | string | 文件格式，当前为 PDF 。 |
| └─ downloadUrl | string | 下载链接，30 天有效。 |
| └─ downloadUrlExpiresAt | string | 链接过期时间，10 位秒级时间戳字符串。 |

### 响应示例

```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\"}"
}
```