GET /apiv2/billing/payments
पोस्टपेड इनवॉइस के लिए आपके भुगतान, और अधिक भुगतान से बचा हुआ क्रेडिट। आप अपने अनुबंध की मुद्रा और नेटवर्क में भुगतान करते हैं — account में settlement देखें। postpaid billing का भाग।
एंडपॉइंट URL
GET https://netts.io/apiv2/billing/paymentsअनुरोध हेडर
| हेडर | आवश्यक | विवरण |
|---|---|---|
X-API-KEY | हाँ | billing.read अनुमति वाली API कुंजी |
X-Real-IP | हाँ | कुंजी श्वेतसूची (व्हाइटलिस्ट) से एक पता |
इस अनुरोध में कोई पैरामीटर नहीं है।
उदाहरण
bash
curl -s 'https://netts.io/apiv2/billing/payments' \
-H 'X-API-KEY: your-api-key' \
-H 'X-Real-IP: 203.0.113.10'json
{
"success": true,
"data": {
"payments": [
{
"id": 7,
"network": "ethereum",
"txHash": "0x8f3c5a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5e21a",
"fromAddress": "0x1111111111111111111111111111111111111111",
"toAddress": "0x2222222222222222222222222222222222222222",
"amountUsdc": "1300.000000",
"confirmedAt": "2026-10-21T09:15:00+00:00",
"status": "confirmed",
"invoiceId": 12
}
],
"creditUsdc": "49.600000"
},
"timestamp": "2026-10-21T09:20:00+00:00"
}फ़ील्ड
| फ़ील्ड | विवरण |
|---|---|
network, txHash | भुगतान का नेटवर्क और ट्रांज़ैक्शन |
fromAddress, toAddress | आपका वॉलेट और Netts भुगतान पता |
amountUsdc | प्राप्त राशि, आपके अनुबंध की मुद्रा में |
confirmedAt | भुगतान कब जमा किया गया था, UTC |
status | confirmed, या reversed यदि भुगतान रद्द कर दिया गया था |
invoiceId | वह इनवॉइस जिसके लिए भुगतान किया गया था, या null |
creditUsdc | आपके इनवॉइस से अधिक भुगतान किया गया पैसा, आपके अनुबंध की मुद्रा में; यह अगले शुल्कों को कवर करता है और limits में creditApplied के रूप में दिखाया जाता है |
किसी इनवॉइस के लिए किया गया भुगतान पहले उस इनवॉइस के शुल्कों को कवर करता है, फिर सबसे पुराने अवैतनिक शुल्कों को; बिना किसी इनवॉइस का भुगतान पहले सबसे पुराने अवैतनिक शुल्कों को कवर करता है। भुगतानों को नवीनतम से पहले क्रमबद्ध किया जाता है; बिना किसी भुगतान वाले खाते को एक खाली सूची मिलती है।
त्रुटियाँ
| HTTP | code | अर्थ |
|---|---|---|
| 401 | -1, -2 | कुंजी गायब या अमान्य है, या IP श्वेतसूची में नहीं है — API गेटवे द्वारा उत्तर दिया गया, देखें प्रतिक्रिया प्रारूप |
| 403 | billing_read_required, postpaid_required | कोई अनुमति नहीं, या कोई पोस्टपेड बिलिंग नहीं |