{
"object": "list",
"data": [
{
"id": "<string>",
"object": "invoice",
"subscription_id": "<string>",
"customer": "<string>",
"amount_due": 123,
"amount_paid": 123,
"amount_remaining": 123,
"currency": "<string>",
"status": "open",
"payment_status": "pending",
"billing_reason": "<string>",
"period_start": 123,
"period_end": 123,
"created": 123,
"frequency": "<string>",
"recurring_interval": "day",
"recurring_interval_count": 123,
"payment_id": "<string>",
"paid_at": 123,
"due_date": 123
}
],
"has_more": true,
"url": "<string>"
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}发票 API
发票列表
分页查询发票列表,支持按订阅、客户、状态筛选。
GET
/
api
/
v1
/
invoices
{
"object": "list",
"data": [
{
"id": "<string>",
"object": "invoice",
"subscription_id": "<string>",
"customer": "<string>",
"amount_due": 123,
"amount_paid": 123,
"amount_remaining": 123,
"currency": "<string>",
"status": "open",
"payment_status": "pending",
"billing_reason": "<string>",
"period_start": 123,
"period_end": 123,
"created": 123,
"frequency": "<string>",
"recurring_interval": "day",
"recurring_interval_count": 123,
"payment_id": "<string>",
"paid_at": 123,
"due_date": 123
}
],
"has_more": true,
"url": "<string>"
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}授权
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日
此页面对您有帮助吗?
