列举二维码支付单

分页查询指定二维码支付下的全部支付单。

GET /api/v1/customer-deposits/{deposit_session_id}/payments

200

{
  "payments": [
    {
      "id": "<string>",
      "amount_total": 123,
      "currency": "<string>",
      "payment_status": "<string>",
      "created": 123,
      "expires_at": 123,
      "url": "<string>",
      "line_items": [
        {}
      ],
      "tax_amount": 123,
      "shipping_amount": 123,
      "exchange_rate": "<string>",
      "target_currency": "<string>",
      "target_amount_total": 123,
      "rate_locked_at": 123,
      "subscription_id": "<string>",
      "invoice_id": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

分页查询指定二维码支付下的全部支付单，按创建时间降序返回。列表包含所有支付状态；二维码支付已关闭或过期时仍可查询历史。

payments 中每项沿用查询支付单接口的字段；空的可选字段省略，id 为支付会话 ID。

​

认证与请求头

使用 Bearer API Key 以及以下三个签名请求头。签名字符串为 {timestamp}.{nonce}.{requestBody}，算法为 HMAC-SHA256，小写 hex。GET 请求的 requestBody 为空字符串。

Authorization · string · 必填

Bearer API Key，例如 Bearer sk_live_xxx。

X-StablePay-Timestamp · string · 必填

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

X-StablePay-Nonce · string · 必填

防重放随机字符串，长度 16–64 个字符；每次请求使用新的 nonce。

X-StablePay-Signature · string · 必填

使用商户 API Secret 计算的 HMAC-SHA256 小写 hex 签名。

​

路径参数

deposit_session_id · string · 必填

二维码支付 ID。

​

查询参数

page · integer · 默认值: 1

页码，从 1 开始。空值、非整数、重复参数或超出范围均返回 400。

page_size · integer · 默认值: 20

每页条数，范围 1–100。空值、非整数、重复参数或超出范围均返回 400。

​

成功响应

HTTP 200，返回指定页及总记录数。空页返回 payments: []，total 仍保留真实总记录数。

payments · object[] · 必填

当前页支付单列表。

显示 支付单字段

id · string · 必填

支付会话 ID。

amount_total · integer · 必填

原订单总金额，使用原订单币种的最小货币单位。

currency · string · 必填

原订单币种的小写代码。

payment_status · string · 必填

允许值：pending、processing、paid、failed、expired、canceled、frozen。

created · integer · 必填

创建时间，Unix 秒。

expires_at · integer · 必填

过期时间，Unix 秒。

url · string

支付页面 URL。

line_items · object[]

商品明细，仅在存在时返回。

tax_amount · integer

税费金额，使用原订单币种的最小货币单位。

shipping_amount · integer

运费金额，使用原订单币种的最小货币单位。

exchange_rate · string

汇率值，仅在存在汇率转换时返回。

target_currency · string

目标支付币种。

target_amount_total · integer

目标支付金额，使用目标币种的最小货币单位。

rate_locked_at · integer

汇率锁定时间，Unix 秒。

subscription_id · string

关联订阅 ID，仅在存在时返回。

invoice_id · string

关联账单 ID，仅在存在时返回。

total · integer · 必填

该二维码支付下的支付单总数，不受当前页影响。

page · integer · 必填

当前页码。

page_size · integer · 必填

本次查询的每页条数。

{
  "payments": [
    {
      "id": "20261113110100101082920000542002",
      "amount_total": 1,
      "currency": "usdc",
      "payment_status": "paid",
      "created": 1794544360,
      "expires_at": 1794544420,
      "url": "https://checkout.example/#/pay/20261113110100101082920000542002/example-token",
      "target_currency": "USDC",
      "target_amount_total": 1
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

​

错误响应

• 400：分页参数无效。
• 401：鉴权失败。
• 404 resource_not_found：二维码支付不存在或不属于当前商户。
• 500：服务内部错误。