GET /apiv2/billing/usage

آپ کے پوسٹ پیڈ چارجز: آرڈر کے ہر الگ سے قابلِ چارج جزو کے لیے ایک لائن، تازہ ترین پہلے۔ سروس فراہم اور ریکارڈ کیے جانے کے بعد ایک لائن ظاہر ہوتی ہے، جو آرڈر کے جواب کے بعد بھی ہو سکتی ہے۔ اسے واجبات اور انوائسز کے ساتھ آرڈرز کو ملانے (reconcile) کے لیے استعمال کریں۔ پوسٹ پیڈ بلنگ کا حصہ۔

اینڈ پوائنٹ URL

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

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

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

کوئری پیرامیٹرز

پیرامیٹر	مطلوب ہے	تفصیل
from	نہیں	اس لمحے سے چارجز، ٹائم زون کے ساتھ ISO 8601: 2026-10-01T00:00:00Z
to	نہیں	اس لمحے سے پہلے کے چارجز، وہی فارمیٹ
limit	نہیں	فی صفحہ لائنیں، 1–500، ڈیفالٹ 100
cursor	نہیں	پچھلے صفحے سے nextCursor

ٹائم زون کے بغیر وقت کو 400 invalid_request کے ساتھ مسترد کر دیا جاتا ہے — مدت مبہم ہو گی۔

مثالیں

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

ایک چارج

فیلڈ	تفصیل
id	چارج نمبر
orderId	وہ آرڈر جس سے یہ چارج تعلق رکھتا ہے — وہی id جو آرڈر کے اینڈ پوائنٹ نے واپس کی تھی
productCode	energy_1h، energy_5m، bandwidth، activation یا aml_check
address	وہ TRON ایڈریس جس کے لیے آرڈر تھا
quantity	Energy یا Bandwidth یونٹس، یا ایکٹیویشن یا چیک کے لیے 1
unitPriceSun	فی یونٹ SUN میں قیمت جو آپ سے وصول کی گئی، آپ کی ذاتی قیمت شامل ہے؛ فی آرڈر قیمت والے پروڈکٹس کے لیے null
discount	اس آرڈر پر ایک الگ رعایت — type percent یا sun_per_unit اور اس کی value — یا null
amountTrx، amountUsdc	اس جزو کی ریکارڈ شدہ رقم، TRX میں اور آپ کے معاہدے کی کرنسی میں
usdPerTrx	اس جزو کے لیے ریکارڈ کردہ TRX کی آپ کے معاہدے کی کرنسی کے ساتھ شرح: اس کے کوٹیشن سے اگر کوٹیشن نے رقم طے کی تھی، بصورت دیگر سروس فراہم کیے جانے کے وقت کی
quoteId	وہ کوٹیشن جو آرڈر نے استعمال کی، اگر کوئی ہو
txHash	اس جزو کی TRON ٹرانزیکشن، جب کوئی موجود ہو
fulfilledAt	جب یہ جزو فراہم کیا گیا تھا، UTC
status	accrued — ابھی انوائس نہیں کی گئی؛ invoiced؛ paid؛ reversed — بعد میں کی جانے والی تصحیح سے منسوخ کر دی گئی
paidTrx، paidUsdc	چارج کا کتنا حصہ پہلے ہی ادا کیا جا چکا ہے، TRX میں اور آپ کے معاہدے کی کرنسی میں
invoiceId	وہ انوائس جس میں یہ شامل ہے
reversesId	تصحیحی لائن کے لیے: وہ چارج جسے یہ منسوخ کرتی ہے

Energy اور ایکٹیویشن والے آرڈر کی دو لائنیں ہوتی ہیں، ایک فی حصہ۔ ایک تصحیح کبھی بھی پرانی لائن میں ترمیم نہیں کرتی: یہ reversesId کے ساتھ ایک نئی لائن کا اضافہ کرتی ہے۔

صفحات

اگلا، پرانا صفحہ حاصل کرنے کے لیے nextCursor کی قیمت بطور cursor بھیجیں۔ آخری صفحے پر nextCursor کی قیمت null ہوتی ہے۔

خرابی کے جوابات

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