GET /apiv2/billing/invoices

آپ کے پوسٹ پیڈ انوائسز۔ آپ کے معاہدے میں طے شدہ بلنگ مدت کے اختتام پر، اس مدت کی خدمات کے لیے ایک انوائس جاری کیا جاتا ہے؛ ہر انوائس کی ادائیگی کی ایک آخری تاریخ (due date) ہوتی ہے۔ پوسٹ پیڈ بلنگ کا حصہ۔

اینڈ پوائنٹس

اینڈ پوائنٹ	واپسی کے نتائج
`GET /apiv2/billing/invoices`	تمام انوائسز، تازہ ترین مدت پہلے
`GET /apiv2/billing/invoices/{id}`	ایک انوائس اپنے چارجز کے ساتھ

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

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

مثال

bash

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

json

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

ہر چارج کے وہی فیلڈز ہیں جو استعمال میں ہیں؛ مثال ان میں سے چند کو ظاہر کرتی ہے۔

ایک انوائس

فیلڈ	تفصیل
`id`	انوائس کا نمبر
`periodStart`، `periodEnd`	بلنگ کی مدت جس کا احاطہ انوائس کرتا ہے، UTC
`totalTrx`، `totalUsdc`	انوائس کا کل میزان، TRX میں اور آپ کے معاہدے کی کرنسی میں
`paidUsdc`	کتنی رقم پہلے ہی ادا کی جا چکی ہے، آپ کے معاہدے کی کرنسی میں
`status`	`issued`، `delivered`، `partially_paid`، `paid` یا `void`
`issuedAt`	انوائس کب جاری کیا گیا تھا
`dueAt`	ادائیگی کی آخری تاریخ
`charges`	صرف `/invoices/{id}` میں: انوائس کے چارجز

فہرست کا اینڈ پوائنٹ charges کے بغیر وہی فیلڈز واپس کرتا ہے۔ وہ اکاؤنٹ جس میں ابھی تک کوئی انوائس نہیں ہے، اسے ایک خالی فہرست ملتی ہے۔

خرابیاں

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

GET /apiv2/billing/invoices ​

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

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

مثال ​

ایک انوائس ​