GET /apiv2/billing/usage

Sonradan ödemeli ücretleriniz: Bir siparişin ayrı ayrı ücretlendirilebilir her bir bileşeni için en yeniden en eskiye doğru bir satır. Bir satır, hizmet sağlandıktan ve kaydedildikten sonra görünür; bu da sipariş yanıtından daha sonra olabilir. Bunu siparişleri borçla ve faturalarla uzlaştırmak için kullanın. Sonradan ödemeli faturalandırmanın bir parçasıdır.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Gerekli	Açıklama
X-API-KEY	evet	billing.read iznine sahip API anahtarı
X-Real-IP	evet	Anahtar beyaz listesindeki bir adres

Sorgu Parametreleri

Parametre	Gerekli	Açıklama
from	hayır	bu andan itibaren olan ücretler, saat dilimi içeren ISO 8601: 2026-10-01T00:00:00Z
to	hayır	bu andan önceki ücretler, aynı biçim
limit	hayır	sayfa başına satır sayısı, 1–500, varsayılan 100
cursor	hayır	önceki sayfadan alınan nextCursor

Saat dilimi belirtilmeyen bir zaman, 400 invalid_request ile reddedilir — dönem belirsiz olacaktır.

Örnek

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

Bir ücret

Alan	Açıklama
id	ücret numarası
orderId	bu ücretin ait olduğu sipariş — sipariş uç noktasının döndürdüğü kimliğin aynısı
productCode	energy_1h, energy_5m, bandwidth, activation veya aml_check
address	siparişin verildiği TRON adresi
quantity	energy veya bandwidth birimleri ya da bir etkinleştirme veya kontrol için 1
unitPriceSun	kişisel fiyatınız dahil olmak üzere sizden SUN cinsinden tahsil edilen birim fiyat; sipariş başına fiyatlandırılan ürünler için null
discount	bu siparişteki ayrı bir indirim — percent veya sun_per_unit tipinde type ve bunun değeri value — ya da null
amountTrx, amountUsdc	bu bileşenin TRX ve sözleşmenizin para birimi cinsinden kaydedilen tutarı
usdPerTrx	bu bileşen için kaydedilen TRX'in sözleşmenizin para birimine oranı: fiyat teklifi tutarı sabitlediyse teklifinden, aksi takdirde hizmetin sağlandığı andaki kur
quoteId	varsa siparişin kullandığı fiyat teklifi
txHash	varsa bu bileşenin TRON işlemi
fulfilledAt	bu bileşenin sağlandığı zaman, UTC
status	accrued — henüz faturalandırılmadı; invoiced; paid; reversed — daha sonraki bir düzeltmeyle iptal edildi
paidTrx, paidUsdc	ücretin TRX ve sözleşmenizin para birimi cinsinden halihazırda ödenmiş olan kısmı
invoiceId	bunu içeren fatura
reversesId	bir düzeltme satırı için: iptal ettiği ücret

Energy ve bir etkinleştirme içeren bir siparişin, her parça için birer tane olmak üzere iki satırı olur. Bir düzeltme asla eski bir satırı düzenlemez: reversesId ile yeni bir satır ekler.

Sayfalar

Bir sonraki, daha eski sayfayı almak için cursor olarak nextCursor değerini gönderin. Son sayfada nextCursor değeri null olur.

Hatalar

HTTP	code	Anlamı
400	invalid_request	hatalı parametre veya saat dilimi içermeyen from/to
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 biçimi
403	billing_read_required, postpaid_required	izin yok veya sonradan ödemeli faturalandırma yok