GET /apiv2/billing/usage

Biaya pascabayar Anda: satu baris per komponen pesanan yang dapat ditagih secara terpisah, yang terbaru terlebih dahulu. Sebuah baris muncul setelah layanan disediakan dan dicatat, yang bisa jadi lebih lambat daripada respons pesanan. Gunakan ini untuk merekonsiliasi pesanan dengan utang dan dengan faktur. Bagian dari penagihan pascabayar.

URL Endpoint

GET https://netts.io/apiv2/billing/usage

Header Permintaan

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

Parameter Kueri

Parameter	Wajib	Deskripsi
from	tidak	biaya dari saat ini, ISO 8601 dengan zona waktu: 2026-10-01T00:00:00Z
to	tidak	biaya sebelum saat ini, format yang sama
limit	tidak	baris per halaman, 1–500, default 100
cursor	tidak	nextCursor dari halaman sebelumnya

Waktu tanpa zona waktu akan ditolak dengan 400 invalid_request — periodenya akan menjadi ambigu.

Contoh

curl -s 'https://netts.io/apiv2/billing/usage?from=2026-10-01T00:00:00Z&limit=2' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "quantity": 65000,
        "unitPriceSun": "20.000000",
        "discount": null,
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "usdPerTrx": "0.330842760000000000",
        "quoteId": null,
        "txHash": "5c1f0e0d3a2b4c6d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f",
        "fulfilledAt": "2026-10-19T10:11:42.563494+00:00",
        "status": "accrued",
        "paidTrx": "0.000000",
        "paidUsdc": "0.000000",
        "invoiceId": null,
        "reversesId": null
      }
    ],
    "nextCursor": 1023
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

Suatu biaya

Bidang	Deskripsi
id	nomor biaya
orderId	pesanan tempat biaya ini berasal — id yang sama dengan yang dikembalikan oleh endpoint pesanan
productCode	energy_1h, energy_5m, bandwidth, activation atau aml_check
address	alamat TRON tujuan pesanan
quantity	unit Energy atau Bandwidth, atau 1 untuk aktivasi atau pemeriksaan
unitPriceSun	harga per unit dalam SUN yang dikenakan kepada Anda, termasuk harga pribadi Anda; null untuk produk yang diberi harga per pesanan
discount	diskon terpisah pada pesanan ini — type percent atau sun_per_unit dan value-nya — atau null
amountTrx, amountUsdc	jumlah tercatat dari komponen ini, dalam TRX dan dalam mata uang kontrak Anda
usdPerTrx	nilai tukar TRX terhadap mata uang kontrak Anda yang dicatat untuk komponen ini: dari penawarannya jika penawaran tersebut menetapkan jumlahnya, jika tidak, pada saat layanan disediakan
quoteId	penawaran yang digunakan pesanan, jika ada
txHash	transaksi TRON dari komponen ini, jika ada
fulfilledAt	saat komponen ini disediakan, UTC
status	accrued — belum ditagih; invoiced; paid; reversed — dibatalkan oleh koreksi berikutnya
paidTrx, paidUsdc	berapa banyak dari biaya yang telah dibayar, dalam TRX dan dalam mata uang kontrak Anda
invoiceId	faktur yang memuatnya
reversesId	untuk baris koreksi: biaya yang dibatalkannya

Pesanan dengan Energy dan aktivasi memiliki dua baris, satu per bagian. Koreksi tidak pernah mengedit baris lama: koreksi menambahkan baris baru dengan reversesId.

Halaman

Kirim nilai nextCursor sebagai cursor untuk mendapatkan halaman berikutnya yang lebih lama. nextCursor bernilai null pada halaman terakhir.

Respons Kesalahan

HTTP	code	Arti
400	invalid_request	parameter salah, atau from/to tanpa zona waktu
401	-1, -2	kunci tidak ada atau tidak valid, atau IP tidak masuk daftar putih — dijawab oleh gateway API, lihat format respons
403	billing_read_required, postpaid_required	tidak ada izin, atau tidak ada penagihan pascabayar