GET /apiv2/billing/invoices

Faturalı (postpaid) faturalarınız. Sözleşmenizde belirlenen faturalandırma döneminin sonunda, o dönemin hizmetleri için bir fatura düzenlenir; her faturanın bir son ödeme tarihi vardır. Faturalı ödeme kapsamındadır.

Uç Noktalar

Uç Nokta	Döndürür
GET /apiv2/billing/invoices	en yeni dönem başta olmak üzere tüm faturalar
GET /apiv2/billing/invoices/{id}	masraflarıyla birlikte tek bir fatura

İ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 beyaz listesindeki bir adres

Örnek

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

Her bir masraf kullanım bölümündeki alanlarla aynı alanlara sahiptir; örnek bunlardan birkaçını göstermektedir.

Bir fatura

Alan	Açıklama
id	fatura numarası
periodStart, periodEnd	faturanın kapsadığı faturalandırma dönemi, UTC
totalTrx, totalUsdc	TRX cinsinden ve sözleşmenizin para biriminde fatura toplamı
paidUsdc	sözleşmenizin para biriminde hâlihazırda ödenmiş olan tutar
status	issued, delivered, partially_paid, paid veya void
issuedAt	faturanın düzenlendiği tarih
dueAt	son ödeme tarihi
charges	yalnızca /invoices/{id} içinde: faturaya ait masraflar

Liste uç noktası charges alanı olmadan aynı alanları döndürür. Henüz faturası olmayan bir hesap boş bir liste alır.

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, postpaid_required	izin yok veya faturalı ödeme tanımlı değil
404	not_found	hesabınızda böyle bir fatura bulunamadı