इनवॉइस की सूची
अनुरोध
curl -X POST https://api.bitsby.app/invoices/list \
-H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
-F "startDate=2000-01-01" \
-F "endDate=2030-01-01" \
-F "offset=0" \
-F "limit=10"
अनुरोध पैरामीटर
| पैरामीटर | डेटा टाइप | विवरण | उदाहरण | अनिवार्य? | डिफ़ॉल्ट |
|---|---|---|---|---|---|
invoiceId | UUID | UUID फ़ॉर्मैट में इनवॉइस ID | 1c48b092-9878-48f5-b441-07a8a48e7b54 | नहीं | |
invoiceUid | String | इनवॉइस ID (ग्राहक के लिए) | F7ncQviM1N92 | नहीं | |
projectId | UUID | UUID फ़ॉर्मैट में प्रोजेक्ट ID | 1c48b092-9878-48f5-b441-07a8a48e7b54 | नहीं | |
startDate | String | इनवॉइस बनने की शुरुआती तारीख़, Y-m-d फ़ॉर्मैट में | 2000-01-01 | नहीं | |
endDate | String | इनवॉइस बनने की आख़िरी तारीख़, Y-m-d फ़ॉर्मैट में | 2030-01-01 | नहीं | |
status | String | इनवॉइस की स्थिति। मान्य मान: unpaid, canceled, paid, expired | paid | नहीं | |
offset | Integer | लौटाए जाने वाले पहले रिकॉर्ड का इंडेक्स | 0 | नहीं | 0 |
limit | Integer | कितने रिकॉर्ड चाहिए, उनकी संख्या | 50 | नहीं | 10 |
जवाब का उदाहरण
{
"result": "success",
"data": [
{
"id": "59302b02-d1be-4e10-960f-d6ec24bfcaaf",
"uid": "F7nYgvxM1N92",
"projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
"createDatetime": "2024-02-29 10:49:56",
"timeToPayDatetime": "2024-02-29 22:49:56",
"commissionFiatUSD": 1,
"amountFiatUSD": 100,
"amountFiat": 100,
"currencyFiat": "USD",
"description": null,
"serviceData": null,
"views": 0,
"status": "canceled"
},
{
"id": "f31c61f6-407f-4999-95cf-56477eff06d4",
"uid": "riUZBnNvd2rX",
"projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
"createDatetime": "2024-02-27 20:57:23",
"timeToPayDatetime": "2024-02-28 08:57:23",
"commissionFiatUSD": 0.12,
"amountFiatUSD": 12,
"amountFiat": 12,
"currencyFiat": "USD",
"description": null,
"serviceData": "orderId:2444",
"views": 3,
"status": "paid",
"payment": {
"id": "f986ad8d-2298-473d-982a-efbc817b975d",
"amount": 12,
"hash": "f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
"transactionDatetime": "2024-02-27 21:05:36"
},
"wallet": {
"id": "47aa71e2-07a0-482e-9172-7114d7376ba0",
"name": "usdt-tron",
"blockchain": "tron",
"cryptocurrency": "usdt",
"address": "TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
}
}
]
}
जवाब पैरामीटर
| पैरामीटर | विवरण |
|---|---|
id | UUID फ़ॉर्मैट में इनवॉइस ID |
uid | इनवॉइस ID (ग्राहक के लिए) |
projectId | UUID फ़ॉर्मैट में प्रोजेक्ट ID |
createDatetime | इनवॉइस बनने की तारीख़ और समय (UTC) |
timeToPayDatetime | वह तारीख़ और समय, जब तक इनवॉइस मान्य है (UTC)। ग्राहक को इस समय से पहले इनवॉइस का भुगतान करना होता है |
commissionFiatUSD | सेवा शुल्क की राशि। इसकी गणना amountFiatUSD राशि से होती है |
amountFiatUSD | USD में बदली इनवॉइस की राशि। इनवॉइस बनाते समय इसकी गणना amountFiat से मौजूदा विनिमय दर पर होती है। भुगतान के समय इसमें असल में मिली राशि लिख दी जाती है, जो उस पल की विनिमय दर पर USD में बदली जाती है। commissionFiatUSD का शुल्क भी इसी से दोबारा गिना जाता है |
amountFiat | फ़िएट मुद्रा में इनवॉइस की मूल राशि। नहीं बदलती |
currencyFiat | फ़िएट मुद्रा |
description | इनवॉइस बनाते समय सेट किया गया विवरण। ग्राहक को दिखता है |
serviceData | इनवॉइस बनाते समय सेट किया गया सर्विस डेटा। ग्राहक को नहीं दिखता। व्यापारी के स्टोर में इनवॉइस और भुगतान की पहचान के लिए इस्तेमाल होता है |
views | भुगतान पृष्ठ के व्यू की संख्या |
status | इनवॉइस की स्थिति |
payment | भुगतान के पैरामीटर वाला ब्लॉक। तब होता है, जब इनवॉइस का भुगतान हुआ हो |
payment.id | UUID फ़ॉर्मैट में भुगतान ID |
payment.amount | क्रिप्टोकरेंसी में भुगतान की राशि |
payment.hash | ऑन-चेन ट्रांज़ैक्शन का hash |
payment.transactionDatetime | ऑन-चेन ट्रांज़ैक्शन की तारीख़ और समय (UTC) |
wallet | उस वॉलेट के पैरामीटर वाला ब्लॉक, जिस पर भुगतान आया। तब होता है, जब इनवॉइस का भुगतान हुआ हो |
wallet.id | UUID फ़ॉर्मैट में वॉलेट ID |
wallet.name | वॉलेट का नाम |
wallet.blockchain | क्रिप्टो वॉलेट का ब्लॉकचेन |
wallet.cryptocurrency | वॉलेट की क्रिप्टोकरेंसी |
wallet.address | क्रिप्टो वॉलेट का एड्रेस |