GET /apiv2/billing/payments

پوسٹ پیڈ انوائسز کے لیے آپ کی ادائیگیاں، اور زائد ادائیگیوں سے بچ جانے والا کریڈٹ۔ آپ اپنے معاہدے کی کرنسی اور نیٹ ورک میں ادائیگی کرتے ہیں — account میں settlement دیکھیں۔ postpaid billing کا حصہ۔

اینڈ پوائنٹ URL

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

درخواست کے ہیڈرز

ہیڈر	درکار ہے	تفصیل
`X-API-KEY`	ہاں	`billing.read` اجازت کے ساتھ API کلید
`X-Real-IP`	ہاں	کلید کی وائٹ لسٹ سے ایک پتہ

درخواست کا کوئی پیرامیٹر نہیں ہے۔

مثال

bash

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

json

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

فیلڈز

فیلڈ	تفصیل
`network`، `txHash`	ادائیگی کا نیٹ ورک اور ٹرانزیکشن
`fromAddress`، `toAddress`	آپ کا والیٹ اور Netts ادائیگی کا پتہ
`amountUsdc`	موصول شدہ رقم، آپ کے معاہدے کی کرنسی میں
`confirmedAt`	ادائیگی کب جمع ہوئی، UTC
`status`	`confirmed`، یا `reversed` اگر ادائیگی منسوخ کر دی گئی ہو
`invoiceId`	وہ انوائس جس کے لیے ادائیگی کی گئی تھی، یا `null`
`creditUsdc`	آپ کے انوائسز سے زیادہ ادا کی گئی رقم، آپ کے معاہدے کی کرنسی میں؛ یہ اگلے چارجز کا احاطہ کرتی ہے اور limits میں `creditApplied` کے طور پر دکھائی جاتی ہے

کسی انوائس کے لیے کی جانے والی ادائیگی پہلے اس انوائس کے چارجز کو پورا کرتی ہے، پھر سب سے پرانے غیر ادا شدہ چارجز کو؛ بغیر انوائس کے کی جانے والی ادائیگی پہلے سب سے پرانے غیر ادا شدہ چارجز کو پورا کرتی ہے۔ ادائیگیاں تازہ ترین کے لحاظ سے پہلے درج کی جاتی ہیں؛ بغیر کسی ادائیگی والے اکاؤنٹ کو خالی فہرست ملتی ہے۔

نقائص

HTTP	`code`	مطلب
401	`-1`، `-2`	کلید غائب یا غلط ہے، یا IP وائٹ لسٹ میں شامل نہیں ہے — API گیٹ وے کی طرف سے جواب دیا گیا، دیکھیں جواب کی ساخت
403	`billing_read_required`، `postpaid_required`	کوئی اجازت نہیں، یا کوئی پوسٹ پیڈ بلنگ نہیں

GET /apiv2/billing/payments ​

اینڈ پوائنٹ URL ​

درخواست کے ہیڈرز ​

مثال ​

فیلڈز ​