GET /apiv2/billing/invoices

Faktur pascabayar Anda. Pada akhir periode penagihan yang ditetapkan dalam kontrak Anda, faktur diterbitkan untuk layanan pada periode tersebut; setiap faktur memiliki tanggal jatuh tempo. Bagian dari penagihan pascabayar.

Endpoint

Endpoint	Mengembalikan
GET /apiv2/billing/invoices	semua faktur, periode terbaru terlebih dahulu
GET /apiv2/billing/invoices/{id}	satu faktur beserta biaya-biayanya

Header Permintaan

Header	Diperlukan	Deskripsi
X-API-KEY	ya	Kunci API dengan izin billing.read
X-Real-IP	ya	Alamat dari daftar putih kunci

Contoh

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

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

Setiap biaya memiliki bidang yang sama seperti pada penggunaan; contoh hanya menampilkan beberapa di antaranya.

Faktur

Bidang	Deskripsi
id	nomor faktur
periodStart, periodEnd	periode penagihan yang dicakup faktur, UTC
totalTrx, totalUsdc	total faktur, dalam TRX dan dalam mata uang kontrak Anda
paidUsdc	jumlah yang sudah dibayar, dalam mata uang kontrak Anda
status	issued, delivered, partially_paid, paid atau void
issuedAt	waktu faktur diterbitkan
dueAt	batas tanggal pembayaran
charges	hanya di /invoices/{id}: biaya-biaya dari faktur

Endpoint daftar mengembalikan bidang yang sama tanpa charges. Akun yang belum memiliki faktur akan menerima daftar kosong.

Kesalahan

HTTP	code	Arti
401	-1, -2	kunci tidak ada atau tidak valid, atau IP tidak terdaftar di daftar putih — dijawab oleh gateway API, lihat format respons
403	billing_read_required, postpaid_required	tidak ada izin, atau tidak ada penagihan pascabayar
404	not_found	tidak ada faktur tersebut pada akun Anda