GET /apiv2/billing/account

Bir bakışta sonradan ödemeli hesabınız: Netts tarafından belirlenen kredi limiti, kendi genel limitiniz, borcunuz ve şu anda daha ne kadar harcayabileceğiniz. Sonradan ödemeli faturalandırma bölümünün parçasıdır.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Zorunlu	Açıklama
X-API-KEY	evet	billing.read iznine sahip API anahtarı
X-Real-IP	evet	Anahtarın beyaz listesinde yer alan bir adres

İsteğin herhangi bir parametresi yoktur.

Örnek

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

Yanıt alanları

Alan	Açıklama
mode	postpaid ya da hesabın sonradan ödemeli faturalandırması duraklatıldığında prepaid
adminLimit	Netts tarafından belirlenen kredi limiti. editable her zaman false değerindedir
clientLimit	kendi genel limitiniz ya da bir limit belirlemediyseniz null
adminLimit.used / clientLimit.used	limitin ne kadarının kullanıldığı
adminLimit.available / clientLimit.available	limitten ne kadar kaldığı
creditApplied	bu limitteki borcu halihazırda azaltan, fazla ödemelerinizden kaynaklanan krediniz
status	ok, limit_reached ya da şu anda hesaplanamıyorsa unavailable
effectiveAvailable	şu anda harcayabileceğiniz miktar: iki available değerinden daha küçük olanı
pendingUnbilled	ücret tahsilatı henüz kaydedilmekte olan kabul edilmiş siparişler: bunların TRX toplamı ve sayısı
asOf	rakamların hesaplandığı an
settlement	sözleşmeniz kapsamında faturaları nasıl ödediğiniz: para birimi, ağ ve bir faturayı ödemek için tanınan gün sayısı
limit, unpaid, creditUsdc, available	Netts limiti, TRX cinsinden ve sözleşmenizin para birimi cinsinden ödenmemiş tutar, krediniz ve Netts limitinden geriye kalan miktar
availableTrxEquiv, availableUsdEquiv	fx içindeki kur üzerinden dönüştürülmüş available; kur mevcut olmadığında null
fx	TRX'in sözleşmenizin para birimine göre güncel kuru ve bu kurun alındığı an. Karşılaştırma amaçlı bir tahmindir, gelecekteki bir siparişin kuru değildir — bkz. kaydedilen döviz kuru
fxStatus	ok ya da unavailable — bu durumda eşdeğer değerler null olur, tutarlar gösterilmeye devam eder

used ve available, bir siparişin kontrol edildiği yöntemle hesaplanır; dolayısıyla effectiveAvailable, bir sonraki siparişin kullanabileceği miktardır. Ürün limitleri limitler bölümünde gösterilmektedir.

Hatalar

HTTP	code	Anlamı
401	-1, -2	anahtar eksik veya geçersiz ya da IP beyaz listede değil — API ağ geçidi tarafından yanıtlanır, bkz. yanıt formatı
403	billing_read_required	anahtarın billing.read izni yok
403	postpaid_required	hesabın sonradan ödemeli faturalandırması yok

Tüm kodlar sonradan ödemeli faturalandırma bölümünde listelenmiştir.