1. 接口概述
简要描述:- 根据代付订单号生成支付凭证 PDF 文件(只有当订单状态为成功或失败时);当只传一个订单号时返回单个 PDF 文件,多笔订单时返回 ZIP 压缩包。
- HTTP Method:
POST - Content-Type:
application/json
/common/voucher/pdf
2. 请求参数
请求体:JSON3. 请求示例
3.1 单个订单号示例(返回 PDF)
请求体示例:3.2 多个订单号示例(返回 ZIP)
请求体示例:4. 响应说明
4.1 成功响应
- HTTP 状态码:
200 - 响应体:二进制文件流
- 当
orderNos只有 1 个订单号时:- 返回单个 PDF 文件
Content-Type通常为:application/pdf
- 当
orderNos包含多个订单号时:- 返回 ZIP 压缩包
Content-Type通常为:application/zip
- 当
建议:
- 根据响应头
Content-Type以及文件大小,将响应体按二进制方式直接保存到本地文件。- 文件名可根据业务自行命名,也可从响应头
Content-Disposition中 获取:例如attachment;filename*=UTF-8''vouchers_20251229200623.zip。- 该api接口请求时间随订单数量进行增加,可能达到 30s+,注意保持网络的稳定。。

