GET /apiv2/billing/usage

आपके पोस्टपेड शुल्क: किसी ऑर्डर के प्रत्येक अलग से प्रभार्य घटक के लिए एक पंक्ति, सबसे नया पहले। सेवा की आपूर्ति और रिकॉर्ड किए जाने के बाद एक पंक्ति दिखाई देती है, जो ऑर्डर प्रतिक्रिया की तुलना में बाद में हो सकती है। इसका उपयोग ऑर्डर का बकाए और इनवॉयस के साथ मिलान करने के लिए करें। पोस्टपेड बिलिंग का भाग।

एंडपॉइंट URL

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

अनुरोध हेडर

हेडर	आवश्यक	विवरण
`X-API-KEY`	हाँ	`billing.read` अनुमति वाली API कुंजी
`X-Real-IP`	हाँ	कुंजी श्वेतसूची (whitelist) से एक पता

क्वेरी पैरामीटर

पैरामीटर	आवश्यक	विवरण
`from`	नहीं	इस क्षण से शुल्क, समय क्षेत्र (time zone) के साथ ISO 8601: `2026-10-01T00:00:00Z`
`to`	नहीं	इस क्षण से पहले के शुल्क, समान प्रारूप
`limit`	नहीं	प्रति पृष्ठ पंक्तियाँ, 1–500, डिफ़ॉल्ट 100
`cursor`	नहीं	पिछले पृष्ठ से `nextCursor`

समय क्षेत्र के बिना समय को 400 invalid_request के साथ अस्वीकार कर दिया जाता है — अवधि अस्पष्ट होगी।

उदाहरण

bash

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'

json

{
  "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 के साथ एक नई पंक्ति जोड़ता है।

पृष्ठ

अगला, पुराना पृष्ठ प्राप्त करने के लिए cursor के रूप में nextCursor मान भेजें। अंतिम पृष्ठ पर nextCursor null होता है।

त्रुटियाँ

HTTP	`code`	अर्थ
400	`invalid_request`	गलत पैरामीटर, या समय क्षेत्र के बिना `from`/`to`
401	`-1`, `-2`	कुंजी अनुपलब्ध या अमान्य है, या IP श्वेतसूची में नहीं है — API गेटवे द्वारा उत्तर दिया गया, देखें प्रतिक्रिया प्रारूप
403	`billing_read_required`, `postpaid_required`	कोई अनुमति नहीं, या कोई पोस्टपेड बिलिंग नहीं

GET /apiv2/billing/usage ​

एंडपॉइंट URL ​

अनुरोध हेडर ​

क्वेरी पैरामीटर ​

उदाहरण ​

एक शुल्क ​

पृष्ठ ​

त्रुटियाँ ​