पोस्टपेड बिलिंग

पोस्टपेड बिलिंग के साथ आप पहले डिपॉज़िट टॉप अप किए बिना Energy, Bandwidth, एक्टिवेशन और AML जांच का ऑर्डर देते हैं। सेवाओं की कीमत लागू ग्राहक-विशिष्ट टैरिफ का उपयोग करके तय की जाती है, जिसमें लागू छूट भी शामिल है। आपके अनुबंध के बिलिंग और भुगतान शर्तों के तहत आपके इनवॉइस में शुल्क, भुगतान और समायोजन दर्शाए जाते हैं।

व्यावसायिक खातों के लिए अनुरोध पर Netts द्वारा पोस्टपेड सक्षम किया जाता है। इस अनुभाग के एंडपॉइंट केवल पोस्टपेड बिलिंग वाले खातों के लिए उत्तर देते हैं; अन्य खातों को 403 postpaid_required प्राप्त होता है।

यह कैसे काम करता है

1. आप हमेशा की तरह ऑर्डर करते हैं। वही ऑर्डर एंडपॉइंट, वही API कुंजी। इन ऑर्डरों के लिए पोस्टपेड खाते को डिपॉज़िट बैलेंस की आवश्यकता नहीं होती है। कीमत आपके अनुबंध के तहत दी गई कीमत है, जिसमें आपकी छूट भी शामिल है।
2. आपूर्ति की गई सेवाओं को शुल्क के रूप में दर्ज किया जाता है। एक स्वीकृत ऑर्डर अपने आप में आपूर्ति की गई सेवा नहीं है। सेवा या ऑर्डर के अलग से प्रभार्य भाग की आपूर्ति हो जाने के बाद उपयोग में एक शुल्क दिखाई देता है — यह ऑर्डर प्रतिक्रिया की तुलना में बाद में हो सकता है।
3. कीमत और दर निश्चित और सुरक्षित रखी जाती हैं। एक वैध कोटेशन उस ऑर्डर के लिए आपके अनुबंध के तहत कीमत तय करता है। कोटेशन के बिना, ऑर्डर दिए जाने के समय आपके अनुबंध के तहत लागू कीमत मान्य होती है, और सेवा की आपूर्ति के समय की दर पर आपके अनुबंध की मुद्रा में राशि की गणना की जाती है। जब आप उपयोग पढ़ते हैं, इनवॉइस प्राप्त करते हैं या भुगतान करते हैं, तो दर्ज की गई राशियों की पुनर्गणना नहीं की जाती है।
4. आप अपना इनवॉइस प्राप्त करते हैं और भुगतान करते हैं। बिलिंग अवधि और भुगतान शर्तें वे हैं जो आपके अनुबंध में सहमत हैं। एक इनवॉइस अवधि की सेवाओं, लागू किए गए भुगतानों और समायोजनों, और अभी भी देय राशि को दिखाता है; भुगतान करने से सेवा रिकॉर्ड नहीं हटते हैं। इनवॉइस और भुगतान देखें। भुगतान मुद्रा, नेटवर्क और भुगतान अवधि खाता में settlement में दिखाई जाती है। अधिक भुगतान आपके खाते में क्रेडिट के रूप में रहता है और अगले शुल्कों के लिए उपयोग किया जाता है।

टैरिफ, कोटेशन और दर्ज की गई विनिमय दर

एक कोटेशन (freezePrice) एक मिनट के लिए आपके अनुबंध के तहत कीमत तय करता है। उस मिनट के भीतर quoteId और समान मापदंडों के साथ ऑर्डर दें, और इसे कोट की गई कीमत पर बिल किया जाता है, भले ही कीमत बदल जाए या सेवा बाद में आपूर्ति की जाए। कोटेशन वैकल्पिक है; अनुरोध फ़ील्ड के लिए 1-घंटे की Energy और 5-मिनट की Energy देखें।

कोटेशन के बिना, आपके अनुबंध की मुद्रा में राशि की गणना सेवा की आपूर्ति के समय की दर पर की जाती है, न कि तब जब आपने कीमत या अपने खाते को देखा था। वर्तमान दर — आपकी दर और खाता प्रतिक्रियाओं में दिखाई गई दर — केवल तुलना के लिए है; यह भविष्य के ऑर्डर की दर का वादा नहीं है।

AML जांच की कीमत अमेरिकी डॉलर में तय की जाती है और आपके अनुबंध की मुद्रा में दर्ज की जाती है; TRX समतुल्य की गणना जांच पूरी होने के समय की दर पर की जाती है। किसी AML शुल्क की उसके राउंड किए गए TRX राशि से पुनर्गणना न करें।

राशियाँ TRX में और आपके अनुबंध की मुद्रा में दिखाई जाती हैं; आपकी सीमाएं आपके अनुबंध की मुद्रा में गिनी जाती हैं। usdPerTrx आपके अनुबंध की मुद्रा में TRX की दर है। आप अपने अनुबंध की मुद्रा और नेटवर्क में भुगतान करते हैं, जो settlement में दिखाया गया है।

एक ऑर्डर में एक से अधिक शुल्क हो सकते हैं, उदाहरण के लिए Energy और एक अलग से प्रभार्य एक्टिवेशन। प्रत्येक शुल्क का अपना समय और दर होती है। राशियों को एक बार छह दशमलव स्थानों तक राउंड किया जाता है, हाफ़-ईवन; एक कोटेशन अपनी कोट की गई राशियों को बनाए रखता है। किसी ऑर्डर का मिलान उसके शुल्कों के आधार पर करें, न कि उसके कुल पर वर्तमान दर लागू करके।

सभी समय UTC हैं। सभी राशियाँ दशमलव स्ट्रिंग हैं, उदाहरण के लिए "30000.000000" — उन्हें दशमलव प्रकार के साथ पार्स करें, फ्लोट के साथ नहीं।

क्रेडिट सीमा

Netts आपके खाते की क्रेडिट सीमा निर्धारित करता है: वह अधिकतम राशि जो आप किसी भी क्षण देय हो सकते हैं। इसे खाता और सीमाएं में "origin": "netts" के साथ दिखाया गया है। आप इसे देख सकते हैं लेकिन इसे बदल या बंद नहीं कर सकते हैं — यदि आपको एक अलग सीमा की आवश्यकता है तो अपने Netts प्रबंधक से पूछें।

उत्पाद और API कुंजियाँ इस एक खाता-स्तरीय क्रेडिट सीमा को साझा करते हैं। प्रत्येक नए ऑर्डर की जांच प्रत्येक लागू सीमा के विरुद्ध की जाती है। जब उस जांच में अपर्याप्त उपलब्ध क्रेडिट पाया जाता है, तो निष्पादन से पहले ऑर्डर अस्वीकार कर दिया जाता है:

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

ऑर्डर एंडपॉइंट 402 उत्तर देता है। एक भुगतान सीमा को फिर से मुक्त कर देता है। यदि जांच अस्थायी रूप से अनुपलब्ध है, तो ऑर्डर एंडपॉइंट कोड 5036 के साथ 503 उत्तर देता है — बाद में पुनः प्रयास करें, अस्वीकृत प्रयास द्वारा कुछ भी चार्ज नहीं किया गया था। एक पठन अनुरोध द्वारा दिखाई गई उपलब्ध राशि वर्तमान आंकड़ा है, बाद के ऑर्डर के लिए आरक्षण नहीं; अन्य स्वीकृत ऑर्डर इसे बदल सकते हैं।

आपकी अपनी सीमाएं

Netts सीमा के भीतर आप खर्च को नियंत्रण में रखने या व्यक्तिगत उत्पादों को प्रतिबंधित करने के लिए अपनी स्वयं की, निचली सीमाएं निर्धारित कर सकते हैं:

• आपकी अपनी समग्र सीमा — वह कुल राशि जो आप अपने आप को देय होने की अनुमति देते हैं, Netts सीमा से नीचे।
• एक उत्पाद सीमा — एक उत्पाद कितना उपयोग कर सकता है, उदाहरण के लिए energy_5m।

आपकी सीमाएं कभी भी क्रेडिट नहीं जोड़ती हैं। उत्पाद सीमाएं आपस में जुड़ती नहीं हैं: 50 USD की Netts सीमा के साथ, energy_1h के लिए 50 USD और energy_5m के लिए 50 USD की उत्पाद सीमाएं अभी भी खाता-स्तरीय क्रेडिट के 50 USD साझा करती हैं। ऑर्डर जांच प्रत्येक प्रासंगिक सीमा को लागू करती है, और सीमाएं प्रत्येक उत्पाद के लिए दिखाती है कि वर्तमान में कितना खर्च किया जा सकता है।

एक सीमा गणना कर सकती है:

period	क्या गिना जाता है
outstanding	अवैतनिक शुल्क, साथ ही स्वीकृत ऑर्डर जो अभी तक दर्ज नहीं किए गए हैं
day	वर्तमान UTC दिन के शुल्क, भुगतान किए गए शुल्क शामिल हैं, साथ ही स्वीकृत ऑर्डर जो अभी तक दर्ज नहीं किए गए हैं
week	सोमवार 00:00 UTC से वर्तमान UTC सप्ताह के शुल्क, भुगतान किए गए शुल्क शामिल हैं, साथ ही स्वीकृत ऑर्डर जो अभी तक दर्ज नहीं किए गए हैं
order	एक एकल नए ऑर्डर की राशि

एक भुगतान आपके ऋण को कम करता है लेकिन दिन या सप्ताह के उपयोग को रीसेट नहीं करता है। अधिक भुगतान से प्राप्त क्रेडिट को creditApplied के रूप में दिखाया जाता है और यह आपके समग्र ऋण के विरुद्ध एक बार गिना जाता है; यह प्रत्येक उत्पाद सीमा में नहीं जुड़ता है।

आपकी सीमाएं Netts सीमा की मुद्रा में हैं और इससे अधिक नहीं हो सकती हैं। यदि Netts अपनी सीमा को आपकी किसी एक सीमा से नीचे कर देता है, तो निचला लागू प्रतिबंध प्रभावी रहता है।

उत्पाद: energy_1h, energy_5m, bandwidth, activation, aml_check।

API कुंजी अनुमतियाँ

प्रत्येक API कुंजी को इस अनुभाग के लिए एक अनुमति की आवश्यकता होती है। आपका Netts प्रबंधक इसे प्रति कुंजी प्रदान करता है:

अनुमति	अनुमति देता है
billing.read	खाता, दर, सीमाएं, उपयोग, इनवॉइस और भुगतान
limits.write	अपनी स्वयं की सीमाओं को बनाना, बदलना, बंद करना और चालू करना

अनुमति के बिना एंडपॉइंट billing_read_required या forbidden के साथ 403 उत्तर देता है। कुंजी की 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"
}

एक अनुपलब्ध या अमान्य कुंजी, या कुंजी की श्वेतसूची से बाहर के IP से आने वाला अनुरोध, सेवा तक पहुँचने से पहले API गेटवे द्वारा 401 के साथ अस्वीकार कर दिया जाता है:

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

"Invalid API key or IP not in whitelist" के साथ कोड -2 का अर्थ है कि IP कुंजी की श्वेतसूची में नहीं है। एक 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	कुंजी में 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	आपकी दर अस्थायी रूप से अनुपलब्ध है — बाद में पुनः प्रयास करें