GET /apiv2/billing/invoices

Các hóa đơn trả sau của bạn. Vào cuối chu kỳ thanh toán được quy định trong hợp đồng của bạn, một hóa đơn sẽ được phát hành cho các dịch vụ trong chu kỳ đó; mỗi hóa đơn đều có ngày đến hạn. Một phần của thanh toán trả sau.

Endpoint

Endpoint	Trả về
`GET /apiv2/billing/invoices`	tất cả hóa đơn, chu kỳ mới nhất trước
`GET /apiv2/billing/invoices/{id}`	một hóa đơn cùng các khoản phí chi tiết

Headers của yêu cầu

Header	Bắt buộc	Mô tả
`X-API-KEY`	có	Khóa API có quyền `billing.read`
`X-Real-IP`	có	Một địa chỉ IP nằm trong danh sách trắng (whitelist) của khóa

Ví dụ

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"
}

Mỗi khoản phí có các trường tương tự như trong mức sử dụng; ví dụ chỉ hiển thị một vài trường trong số đó.

Một hóa đơn

Trường	Mô tả
`id`	số hóa đơn
`periodStart`, `periodEnd`	chu kỳ thanh toán mà hóa đơn áp dụng, theo UTC
`totalTrx`, `totalUsdc`	tổng tiền hóa đơn, bằng TRX và bằng loại tiền tệ trong hợp đồng của bạn
`paidUsdc`	số tiền đã thanh toán, bằng loại tiền tệ trong hợp đồng của bạn
`status`	`issued`, `delivered`, `partially_paid`, `paid` hoặc `void`
`issuedAt`	thời điểm hóa đơn được phát hành
`dueAt`	ngày đến hạn thanh toán
`charges`	chỉ có trong `/invoices/{id}`: các khoản phí chi tiết của hóa đơn

Endpoint dạng danh sách trả về các trường tương tự nhưng không có charges. Tài khoản chưa có hóa đơn nào sẽ nhận về một danh sách trống.

Lỗi

HTTP	`code`	Ý nghĩa
401	`-1`, `-2`	khóa bị thiếu hoặc không hợp lệ, hoặc IP không nằm trong danh sách trắng — được trả về bởi API gateway, xem định dạng phản hồi
403	`billing_read_required`, `postpaid_required`	không có quyền, hoặc không có thanh toán trả sau
404	`not_found`	không tìm thấy hóa đơn này trên tài khoản của bạn

GET /apiv2/billing/invoices ​

Endpoint ​

Headers của yêu cầu ​

Ví dụ ​

Một hóa đơn ​

Lỗi ​

GET /apiv2/billing/invoices

Endpoint

Headers của yêu cầu

Ví dụ

Một hóa đơn

Lỗi