跳转到主要内容
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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt

Use this file to discover all available pages before exploring further.

授权

Authorization
string
header
必填

Bearer API Key,例如 Bearer sk_live_xxx

X-StablePay-Timestamp
string
header
必填

Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce
string
header
必填

防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。

X-StablePay-Signature
string
header
必填

使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。

请求头

X-StablePay-Timestamp
string
必填

Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce
string
必填

防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。

Required string length: 16 - 64
X-StablePay-Signature
string
必填

使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。

查询参数

subscription_id
string

按订阅 ID 筛选。

customer
string

按客户 ID 筛选。

status
enum<string>

按发票状态筛选,仅支持 openpaidvoid。 发票状态。查询参数必须使用小写值:openpaidvoid

可用选项:
open,
paid,
void
limit
integer
默认值:10

返回数量,默认 10,最大 100。

必填范围: 1 <= x <= 100
starting_after
string

向后分页游标。当前实现按 invoice_id > starting_after 查询。

响应

查询成功。

object
string
示例:

"list"

data
object[]
has_more
boolean

是否还有更多数据。当前实现按返回数量是否等于 limit 判断。

url
string

当前查询 URL。

Last modified on April 30, 2026