GET /apiv2/billing/account

Sekilas tentang akun pascabayar Anda: batas kredit yang ditetapkan oleh Netts, batas keseluruhan Anda sendiri, jumlah tagihan Anda, dan berapa banyak yang masih dapat Anda belanjakan saat ini. Bagian dari penagihan pascabayar.

URL Endpoint

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

Header Permintaan

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

Permintaan ini tidak memiliki parameter.

Contoh

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

{
  "success": true,
  "data": {
    "mode": "postpaid",
    "adminLimit": {
      "id": 1,
      "origin": "netts",
      "limit": { "unit": "USD", "value": "30000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "28749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 3,
      "editable": false
    },
    "clientLimit": {
      "id": 4,
      "origin": "client",
      "limit": { "unit": "USD", "value": "5000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "3749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 2,
      "editable": true
    },
    "effectiveAvailable": { "unit": "USD", "value": "3749.600000" },
    "pendingUnbilled": { "trx": "0", "count": 0 },
    "asOf": "2026-10-19T20:24:26.474237+00:00",
    "settlement": { "asset": "USDC", "network": "ethereum", "paymentTermsDays": 5 },
    "limit": { "unit": "USD", "value": "30000.000000" },
    "unpaid": { "TRX": "3778.500000", "USDC": "1250.400000" },
    "creditUsdc": "0",
    "available": "28749.600000",
    "availableTrxEquiv": "86897.437285",
    "availableUsdEquiv": "28749.600000",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

Bidang Respons

Bidang	Deskripsi
mode	postpaid, atau prepaid saat penagihan pascabayar akun dijeda
adminLimit	batas kredit yang ditetapkan oleh Netts. editable selalu bernilai false
clientLimit	batas keseluruhan Anda sendiri, atau null jika Anda belum mengaturnya
adminLimit.used / clientLimit.used	seberapa banyak batas yang telah digunakan
adminLimit.available / clientLimit.available	sisa batas yang masih tersedia
creditApplied	kredit Anda dari kelebihan pembayaran yang sudah mengurangi utang dalam batas ini
status	ok, limit_reached, atau unavailable jika saat ini tidak dapat dihitung
effectiveAvailable	jumlah yang dapat Anda belanjakan sekarang: nilai terkecil dari kedua nilai available
pendingUnbilled	pesanan yang sudah diterima yang biayanya masih dicatat: total TRX dan jumlahnya
asOf	waktu saat angka-angka tersebut dihitung
settlement	cara Anda membayar faktur berdasarkan kontrak Anda: mata uang, jaringan, dan batas waktu hari untuk membayar faktur
limit, unpaid, creditUsdc, available	batas Netts, jumlah yang belum dibayar dalam TRX dan dalam mata uang kontrak Anda, kredit Anda, dan sisa dari batas Netts
availableTrxEquiv, availableUsdEquiv	available yang dikonversikan dengan kurs di fx; bernilai null jika tidak ada kurs yang tersedia
fx	kurs TRX saat ini terhadap mata uang kontrak Anda dan waktu saat kurs tersebut diambil. Ini merupakan perkiraan untuk perbandingan, bukan kurs dari pesanan di masa mendatang — lihat kurs pertukaran tercatat
fxStatus	ok, atau unavailable — jika demikian nilai ekuivalennya adalah null, jumlah tetap ditampilkan

used dan available dihitung dengan cara yang sama seperti pemeriksaan pesanan, sehingga effectiveAvailable adalah apa yang dapat digunakan oleh pesanan berikutnya. Batas produk ditampilkan di batas.

Error

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	kunci tidak memiliki izin billing.read
403	postpaid_required	akun tidak memiliki penagihan pascabayar

Semua kode tercantum dalam penagihan pascabayar.