GET /apiv2/billing/payments

Faturalı (postpaid) faturalarınız için yaptığınız ödemeler ve fazla ödemelerden kalan bakiye. Sözleşmenizin para birimi ve ağında ödeme yaparsınız — hesap içindeki settlement alanına bakın. Faturalı faturalandırmanın bir parçasıdır.

Uç Nokta URL'si

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

İ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ın beyaz listesinde bulunan bir IP adresi

İsteğin herhangi bir parametresi yoktur.

Örnekler

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

{
  "success": true,
  "data": {
    "payments": [
      {
        "id": 7,
        "network": "ethereum",
        "txHash": "0x8f3c5a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5e21a",
        "fromAddress": "0x1111111111111111111111111111111111111111",
        "toAddress": "0x2222222222222222222222222222222222222222",
        "amountUsdc": "1300.000000",
        "confirmedAt": "2026-10-21T09:15:00+00:00",
        "status": "confirmed",
        "invoiceId": 12
      }
    ],
    "creditUsdc": "49.600000"
  },
  "timestamp": "2026-10-21T09:20:00+00:00"
}

Alanlar

Alan	Açıklama
network, txHash	ödemenin ağı ve işlem karması (txHash)
fromAddress, toAddress	cüzdanınız ve Netts ödeme adresi
amountUsdc	sözleşmenizin para biriminde alınan tutar
confirmedAt	ödemenin hesaba geçtiği zaman, UTC
status	confirmed veya ödeme iptal edildiyse reversed
invoiceId	ödemenin yapıldığı fatura ya da null
creditUsdc	faturalarınızın üzerinde ödenen para, sözleşmenizin para biriminde; sonraki masrafları karşılar ve limitler içinde creditApplied olarak gösterilir

Bir fatura için yapılan ödeme, önce o faturanın masraflarını, ardından en eski ödenmemiş masrafları karşılar; faturasız bir ödeme ise önce en eski ödenmemiş masrafları karşılar. Ödemeler en yeniden en eskiye doğru listelenir; hiç ödemesi 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, yanıt formatı bölümüne bakın
403	billing_read_required, postpaid_required	izin yok veya faturalı (postpaid) faturalandırma bulunmuyor