پوسٹ پیڈ بلنگ

پوسٹ پیڈ بلنگ کے ساتھ آپ پہلے سے ڈیپازٹ ٹاپ اپ کیے بغیر Energy، Bandwidth، ایکٹیویشن اور AML چیکس کا آرڈر دیتے ہیں۔ سروسز کی قیمت قابل اطلاق کسٹمر کے مخصوص ٹیرف بشمول قابل اطلاق رعایتوں کے مطابق طے کی جاتی ہے۔ چارجز، ادائیگیاں اور ایڈجسٹمنٹس آپ کے معاہدے کی بلنگ اور ادائیگی کی شرائط کے تحت آپ کے انوائس میں ظاہر ہوتے ہیں۔

پوسٹ پیڈ کاروباری اکاؤنٹس کے لیے درخواست پر Netts کی جانب سے فعال کیا جاتا ہے۔ اس سیکشن کے اینڈ پوائنٹس صرف پوسٹ پیڈ بلنگ والے اکاؤنٹس کے لیے جواب دیتے ہیں؛ دیگر اکاؤنٹس 403 postpaid_required وصول کرتے ہیں۔

یہ کیسے کام کرتا ہے

1. آپ معمول کے مطابق آرڈر دیتے ہیں۔ وہی آرڈر اینڈ پوائنٹس، وہی API کی (key)۔ پوسٹ پیڈ اکاؤنٹ کو ان آرڈرز کے لیے ڈیپازٹ بیلنس کی ضرورت نہیں ہوتی۔ قیمت آپ کے معاہدے کے تحت طے شدہ قیمت ہوتی ہے، بشمول آپ کی رعایتیں۔
2. فراہم کردہ سروسز کو چارجز کے طور پر ریکارڈ کیا جاتا ہے۔ ایک منظور شدہ آرڈر بذات خود فراہم کردہ سروس نہیں ہوتا۔ ایک چارج usage میں اس وقت ظاہر ہوتا ہے جب سروس یا آرڈر کا الگ سے قابل چارج حصہ فراہم کر دیا جائے — یہ آرڈر کے رسپانس کے بعد بھی ہو سکتا ہے۔
3. قیمت اور شرح مقرر اور برقرار رکھی جاتی ہے۔ ایک درست کوٹیشن (quotation) اس آرڈر کے لیے آپ کے معاہدے کے تحت قیمت مقرر کر دیتی ہے۔ کوٹیشن کے بغیر، آرڈر دیتے وقت آپ کے معاہدے کے تحت موجود قیمت لاگو ہوتی ہے، اور آپ کے معاہدے کی کرنسی میں رقم کا حساب سروس فراہم کیے جانے کے وقت کی شرح پر لگایا جاتا ہے۔ جب آپ یوٹیلائزیشن (usage) پڑھتے ہیں، انوائس وصول کرتے ہیں یا ادائیگی کرتے ہیں تو ریکارڈ شدہ رقوم کا دوبارہ حساب نہیں لگایا جاتا۔
4. آپ اپنا انوائس وصول کرتے ہیں اور ادا کرتے ہیں۔ بلنگ کی مدت اور ادائیگی کی شرائط وہی ہوتی ہیں جو آپ کے معاہدے میں طے پائی ہیں۔ ایک انوائس مدت کی سروسز، لاگو کردہ ادائیگیاں اور ایڈجسٹمنٹس، اور قابل ادائیگی بقایا رقم دکھاتا ہے؛ ادائیگی سروس کے ریکارڈز کو حذف نہیں کرتی ہے۔ invoices اور payments دیکھیں۔ ادائیگی کی کرنسی، نیٹ ورک اور ادائیگی کی مدت account میں settlement میں دکھائی گئی ہے۔ زائد ادائیگی آپ کے اکاؤنٹ پر بطور کریڈٹ رہتی ہے اور اگلے چارجز کے لیے استعمال ہوتی ہے۔

ٹیرف، کوٹیشن اور ریکارڈ شدہ شرح تبادلہ

ایک کوٹیشن (freezePrice) ایک منٹ کے لیے آپ کے معاہدے کے تحت قیمت مقرر کر دیتی ہے۔ اس ایک منٹ کے اندر quoteId اور انہی پیرامیٹرز کے ساتھ آرڈر دیں، اور اس کا بل کوٹ کی گئی قیمت پر ہی بنے گا، چاہے قیمت تبدیل ہو جائے یا سروس بعد میں فراہم کی جائے۔ کوٹیشن اختیاری ہے؛ درخواست کے فیلڈز کے لیے 1-hour energy اور 5-minute energy دیکھیں۔

کوٹیشن کے بغیر، آپ کے معاہدے کی کرنسی میں رقم کا حساب سروس فراہم کیے جانے کے وقت کی شرح پر لگایا جاتا ہے، نہ کہ اس وقت جب آپ نے قیمت دیکھی تھی یا اپنا اکاؤنٹ دیکھا تھا۔ موجودہ شرح — آپ کی شرح اور اکاؤنٹ کے جوابات میں دکھائی گئی شرح — صرف موازنہ کے لیے ہے؛ یہ مستقبل کے آرڈر کی شرح کا کوئی وعدہ نہیں ہے۔

AML چیکس کی قیمت امریکی ڈالرز میں طے کی جاتی ہے اور آپ کے معاہدے کی کرنسی میں ریکارڈ کی جاتی ہے؛ TRX کے مساوی رقم کا حساب چیک مکمل ہونے کے وقت کی شرح پر لگایا جاتا ہے۔ کسی AML چارج کا اس کی راؤنڈ کی گئی TRX رقم سے دوبارہ حساب نہ لگائیں۔

رقوم TRX اور آپ کے معاہدے کی کرنسی میں دکھائی جاتی ہیں؛ آپ کی حدود کا حساب آپ کے معاہدے کی کرنسی میں کیا جاتا ہے۔ usdPerTrx آپ کے معاہدے کی کرنسی کے مقابلے TRX کی شرح ہے۔ آپ اپنے معاہدے کی کرنسی اور نیٹ ورک میں ادائیگی کرتے ہیں، جو settlement میں ظاہر ہے۔

ایک آرڈر میں ایک سے زیادہ چارجز ہو سکتے ہیں، مثال کے طور پر Energy اور الگ سے قابل چارج ایکٹیویشن۔ ہر چارج کا اپنا وقت اور شرح ہوتی ہے۔ رقوم کو ایک بار اعشاریہ کے چھ ہندسوں تک ہاف-ایون (half-even) راؤنڈ کیا جاتا ہے؛ کوٹیشن اپنی کوٹ کی گئی رقوم کو برقرار رکھتی ہے۔ کسی آرڈر کا تصفیہ اس کے چارجز کے ذریعے کریں، نہ کہ اس کے کل پر موجودہ شرح کا اطلاق کر کے۔

تمام اوقات UTC میں ہیں۔ تمام رقوم اعشاریہ کے اسٹرنگز ہیں، مثال کے طور پر "30000.000000" — انہیں فلوٹ کے بجائے ڈیسیمل ٹائپ کے ساتھ پارس کریں۔

کریڈٹ لمٹ

Netts آپ کے اکاؤنٹ کی کریڈٹ لمٹ مقرر کرتا ہے: زیادہ سے زیادہ رقم جو آپ کسی بھی وقت مقروض ہو سکتے ہیں۔ یہ account اور limits میں "origin": "netts" کے ساتھ دکھائی جاتی ہے۔ آپ اسے دیکھ سکتے ہیں لیکن اسے تبدیل یا بند نہیں کر سکتے — اگر آپ کو مختلف حد کی ضرورت ہو تو اپنے Netts مینیجر سے رابطہ کریں۔

پروڈکٹس اور API کیز (keys) اس ایک اکاؤنٹ کی سطح کی کریڈٹ لمٹ کو شیئر کرتی ہیں۔ ہر نئے آرڈر کی ہر قابل اطلاق حد کے تحت تصدیق کی جاتی ہے۔ جب اس تصدیق میں ناکافی دستیاب کریڈٹ پایا جاتا ہے تو آرڈر پر عمل درآمد سے پہلے ہی اسے مسترد کر دیا جاتا ہے:

{
  "detail": {
    "code": 1004,
    "msg": "Postpaid credit limit reached.",
    "paymentMode": "postpaid",
    "reason": "limit_reached",
    "product": "*",
    "period": "outstanding",
    "limitId": 1
  }
}

آرڈر اینڈ پوائنٹ 402 جواب دیتا ہے۔ ادائیگی حد کو دوبارہ بحال کر دیتی ہے۔ اگر تصدیق عارضی طور پر دستیاب نہ ہو تو آرڈر اینڈ پوائنٹ کوڈ 5036 کے ساتھ 503 جواب دیتا ہے — بعد میں دوبارہ کوشش کریں، مسترد شدہ کوشش پر کوئی چارج نہیں لیا گیا۔ ریڈ (read) کی درخواست کے ذریعے دکھائی گئی دستیاب رقم موجودہ عدد ہے، بعد کے آرڈر کے لیے کوئی ریزرویشن نہیں؛ دیگر منظور شدہ آرڈرز اسے تبدیل کر سکتے ہیں۔

آپ کی اپنی حدود

Netts کی حد کے اندر آپ اخراجات کو کنٹرول میں رکھنے یا انفرادی پروڈکٹس کو محدود کرنے کے لیے اپنی، کم حدود مقرر کر سکتے ہیں:

• آپ کی اپنی مجموعی حد — کل رقم جو آپ Netts کی حد سے کم، اپنے لیے مقروض ہونا جائز سمجھتے ہیں۔
• ایک پروڈکٹ کی حد — ایک پروڈکٹ کتنی استعمال کر سکتی ہے، مثال کے طور پر energy_5m۔

آپ کی حدود کبھی بھی کریڈٹ کا اضافہ نہیں کرتیں۔ پروڈکٹ کی حدود آپس میں جمع نہیں ہوتیں: 50 USD کی Netts کی حد کے ساتھ، energy_1h کے لیے 50 USD اور energy_5m کے لیے 50 USD کی پروڈکٹ حدود اب بھی اکاؤنٹ کی سطح پر 50 USD کا کریڈٹ شیئر کرتی ہیں۔ آرڈر کی تصدیق ہر متعلقہ حد کا اطلاق کرتی ہے، اور limits ہر پروڈکٹ کے لیے دکھاتا ہے کہ فی الحال کتنا خرچ کیا جا سکتا ہے۔

ایک حد شمار کر سکتی ہے:

period	کیا شمار کیا جاتا ہے
outstanding	غیر ادا شدہ چارجز، نیز وہ منظور شدہ آرڈرز جو ابھی ریکارڈ نہیں ہوئے
day	موجودہ UTC دن کے چارجز، ادا شدہ سمیت، نیز وہ منظور شدہ آرڈرز جو ابھی ریکارڈ نہیں ہوئے
week	پیر 00:00 UTC سے موجودہ UTC ہفتے کے چارجز، ادا شدہ سمیت، نیز وہ منظور شدہ آرڈرز جو ابھی ریکارڈ نہیں ہوئے
order	ایک سنگل نئے آرڈر کی رقم

ایک ادائیگی آپ کے قرض کو کم کرتی ہے لیکن دن یا ہفتے کے استعمال کو دوبارہ صفر نہیں کرتی۔ زائد ادائیگی سے حاصل ہونے والا کریڈٹ creditApplied کے طور پر دکھایا جاتا ہے اور آپ کے مجموعی قرض کے مقابلے میں ایک بار شمار ہوتا ہے؛ یہ ہر پروڈکٹ کی حد میں شامل نہیں ہوتا۔

آپ کی حدود Netts کی حد کی کرنسی میں ہوتی ہیں اور اس سے زیادہ نہیں ہو سکتیں۔ اگر Netts اپنی حد کو آپ کی کسی حد سے کم کر دیتا ہے تو کم قابل اطلاق پابندی نافذ العمل رہتی ہے۔

پروڈکٹس: energy_1h, energy_5m, bandwidth, activation, aml_check۔

API کی (key) کی اجازتیں

ہر API کی (key) کو اس سیکشن کے لیے اجازت درکار ہوتی ہے۔ آپ کا Netts مینیجر یہ ہر کی (key) کے حساب سے دیتا ہے:

اجازت	اجازت دیتا ہے
billing.read	اکاؤنٹ، شرح، حدود، استعمال، انوائسز اور ادائیگیاں
limits.write	اپنی حدود بنانا، تبدیل کرنا، بند کرنا اور کھولنا

اجازت کے بغیر اینڈ پوائنٹ billing_read_required یا forbidden کے ساتھ 403 جواب دیتا ہے۔ کی (key) کی IP وائٹ لسٹ کا اطلاق باقی ہر اینڈ پوائنٹ کی طرح ہی ہوتا ہے۔ یہ اینڈ پوائنٹس اس وقت بھی دستیاب رہتے ہیں جب ڈیپازٹ بیلنس صفر ہو۔

اینڈ پوائنٹس

اینڈ پوائنٹ	یہ کیا کرتا ہے
GET /apiv2/billing/account	کریڈٹ لمٹ، قرض اور جو کچھ ابھی دستیاب ہے
GET /apiv2/billing/rate	آپ کے معاہدے کی کرنسی کے مقابلے میں TRX کی آپ کی موجودہ شرح
GET /apiv2/billing/limits	تمام حدود استعمال شدہ اور دستیاب رقوم کے ساتھ، فی پروڈکٹ دستیاب
POST /apiv2/billing/limits	اپنی حدود بنائیں، تبدیل کریں، بند کریں اور کھولیں
GET /apiv2/billing/usage	چارج کے اجزاء، اپنے آرڈرز سے منسلک
GET /apiv2/billing/invoices	انوائسز، ایک انوائس اپنے چارجز کے ساتھ
GET /apiv2/billing/payments	ادائیگیاں اور کریڈٹ

رسپانس فارمیٹ

{ "success": true, "data": { }, "timestamp": "2026-10-19T20:12:30+00:00" }

سروس کی جانب سے ایک خرابی:

{
  "success": false,
  "error": { "code": "postpaid_required", "message": "this account has no postpaid billing" },
  "timestamp": "2026-10-19T20:12:30+00:00"
}

ایک گمشدہ یا غلط کی (key)، یا کی (key) کی وائٹ لسٹ سے باہر کسی IP کی درخواست کو API گیٹ وے کے ذریعے سروس تک پہنچنے سے پہلے ہی 401 کے ساتھ مسترد کر دیا جاتا ہے:

{ "detail": { "code": -1, "msg": "Invalid or missing API key" } }

"Invalid API key or IP not in whitelist" کے ساتھ کوڈ -2 کا مطلب ہے کہ IP، کی (key) کی وائٹ لسٹ میں شامل نہیں ہے۔ ایک IP سے فی سیکنڈ 10 سے زیادہ یا فی منٹ 300 سے زیادہ درخواستیں 429 اور {"message": "API rate limit exceeded"} کے ساتھ مسترد کر دی جاتی ہیں۔

HTTP	code	مفہوم
400	invalid_request, invalid_amount, idempotency_key_required, invalid_idempotency_key	کوئی پیرامیٹر غائب ہے یا اس کا فارمیٹ غلط ہے
403	postpaid_required	اکاؤنٹ میں پوسٹ پیڈ بلنگ نہیں ہے
403	postpaid_disabled	پوسٹ پیڈ بلنگ موقوف ہے: آپ پڑھ سکتے ہیں، لیکن حدود تبدیل نہیں کر سکتے
403	billing_read_required, forbidden	کی (key) میں billing.read یا limits.write کی کمی ہے
403	netts_limit_readonly	حد Netts کی طرف سے مقرر کی گئی ہے اور اسے تبدیل نہیں کیا جا سکتا
404	not_found	آپ کے اکاؤنٹ پر ایسی کوئی حد یا انوائس موجود نہیں ہے
409	revision_conflict	اس دوران حد تبدیل کر دی گئی تھی — اسے دوبارہ پڑھیں
409	limit_exists	اس پروڈکٹ اور مدت کے لیے آپ کی حد پہلے سے موجود ہے
409	idempotency_conflict	Idempotency-Key کا استعمال دوسری درخواست کے ساتھ کیا گیا تھا
409	no_account_limit	اکاؤنٹ میں ابھی تک Netts کی طرف سے کوئی کریڈٹ لمٹ مقرر نہیں کی گئی ہے
422	above_account_limit	قیمت Netts کی حد سے زیادہ ہے
422	product_not_postpaid	پروڈکٹ پوسٹ پیڈ پر دستیاب نہیں ہے
422	unit_mismatch	Netts کی حد کی کرنسی تبدیل ہو گئی — اپنی حد فعال کرنے سے پہلے ایک نئی قیمت مقرر کریں
503	unavailable	عارضی طور پر غیر دستیاب ہے — بعد میں دوبارہ کوشش کریں
503	rate_unavailable	آپ کی شرح عارضی طور پر دستیاب نہیں ہے — بعد میں دوبارہ کوشش کریں