发票 API
发票列表
分页查询发票列表,支持按订阅、客户、状态筛选。
GET
授权
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
请求头
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
Required string length:
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
查询参数
按订阅 ID 筛选。
按客户 ID 筛选。
按发票状态筛选,仅支持 open、paid、void。
发票状态。查询参数必须使用小写值:open、paid、void。
可用选项:
open, paid, void 返回数量,默认 10,最大 100。
必填范围:
1 <= x <= 100向后分页游标。当前实现按 invoice_id > starting_after 查询。
最后修改于 2026年4月30日
