GET /apiv2/billing/invoices

您的后付费发票。在您合同中设定的计费周期结束时，系统会针对该周期的服务开具一张发票；每张发票都有一个到期日。属于后付费计费的一部分。

端点

端点	返回内容
`GET /apiv2/billing/invoices`	所有发票，最新周期的排在最前
`GET /apiv2/billing/invoices/{id}`	单张发票及其扣费明细

请求头

请求头	必填	描述
`X-API-KEY`	是	具有 `billing.read` 权限的 API 密钥
`X-Real-IP`	是	来自密钥白名单中的地址

示例

bash

curl -s 'https://netts.io/apiv2/billing/invoices/12' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

json

{
  "success": true,
  "data": {
    "id": 12,
    "periodStart": "2026-10-12T00:00:00+00:00",
    "periodEnd": "2026-10-19T00:00:00+00:00",
    "totalTrx": "3778.500000",
    "totalUsdc": "1250.400000",
    "paidUsdc": "0.000000",
    "status": "issued",
    "issuedAt": "2026-10-19T00:10:00+00:00",
    "dueAt": "2026-10-24T00:10:00+00:00",
    "charges": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "status": "invoiced"
      }
    ]
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

每项扣费明细具有与使用量中相同的字段；示例仅展示了其中的一部分。

发票详情

字段	描述
`id`	发票编号
`periodStart`, `periodEnd`	发票覆盖的计费周期，UTC 时间
`totalTrx`, `totalUsdc`	发票总额，分别以 TRX 和您合同指定的货币计价
`paidUsdc`	已支付金额，以您合同指定的货币计价
`status`	`issued`、`delivered`、`partially_paid`、`paid` 或 `void`
`issuedAt`	发票开具时间
`dueAt`	付款截止日期
`charges`	仅在 `/invoices/{id}` 中提供：发票的扣费明细

列表端点返回相同的字段，但不包含 charges。尚无发票的账户将获得一个空列表。

错误

HTTP	`code`	含义
401	`-1`, `-2`	密钥缺失或无效，或者 IP 不在白名单中 —— 由 API 网关响应，请参见响应格式
403	`billing_read_required`, `postpaid_required`	无权限，或未开通后付费计费
404	`not_found`	您的账户下不存在该发票

GET /apiv2/billing/invoices ​

端点 ​

请求头 ​

示例 ​

发票详情 ​

错误 ​

GET /apiv2/billing/invoices

端点

请求头

示例

发票详情

错误