ادائیگیوں کی فہرست حاصل کریں

جائزہ

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

درخواست

curl -X POST https://api.bitsby.app/payments/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "startDate=2000-01-01" \
	-F "endDate=2030-01-01" \
	-F "offset=0" \
	-F "limit=10"

درخواست کے پیرامیٹرز

پیرامیٹر	ڈیٹا کی قسم	تفصیل	مثال	لازمی؟	ڈیفالٹ
walletId	UUID	UUID فارمیٹ میں والٹ ID	1c48b092-9878-48f5-b441-07a8a48e7b54	نہیں
invoiceId	UUID	UUID فارمیٹ میں انوائس ID	1c48b092-9878-48f5-b441-07a8a48e7b54	نہیں
startDate	String	آن چین ٹرانزیکشن کی ابتدائی تاریخ، Y-m-d فارمیٹ میں	2000-01-01	نہیں
endDate	String	آن چین ٹرانزیکشن کی آخری تاریخ، Y-m-d فارمیٹ میں	2030-01-01	نہیں
offset	Integer	واپس کیے جانے والے پہلے ریکارڈ کا انڈیکس	0	نہیں	0
limit	Integer	ریکارڈز کی تعداد جو آپ حاصل کرنا چاہتے ہیں	50	نہیں	10

جواب کی مثال

انوائس سے پہلے ہی منسلک ادائیگی:

{
   "result":"success",
   "data":[
      {
         "id":"f986ad8d-2298-473d-982a-efbc817b975d",
         "amount":12,
         "hash":"f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
         "transactionDatetime":"2024-02-27 21:05:36",
         "invoice":{
            "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":1,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      },
      {
         "id":"f3195184-9a6f-4c82-928b-d7fe7c015b7b",
         "amount":5.02,
         "hash":"74763b65e43bcc9492a6ce9a7f26fbfdbd7635aecd3454420b5e9534cba50ee6",
         "transactionDatetime":"2024-02-26 13:32:57",
         "invoice":{
            "id":"fac8ef03-2c41-4ce0-a432-7c33b928f16f",
            "uid":"AFhygKX21ecd",
            "projectId":"9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime":"2024-02-26 13:29:24",
            "timeToPayDatetime":"2024-02-27 01:29:24",
            "commissionFiatUSD":0.05,
            "amountFiatUSD":5.02, 
            "amountFiat":5,
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"orderId:3419",
            "views":3,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

ایسی ادائیگی جو سروس کو مل گئی ہے لیکن ابھی کسی انوائس سے منسلک نہیں ہوئی، invoice آبجیکٹ کے بغیر آتی ہے۔ یہی ادائیگیاں دستی طور پر منسلک کرنے کی امیدوار ہیں:

{
   "result":"success",
   "data":[
      {
         "id":"c1d0f4a2-93b7-4f61-8c25-1a6f0e2b7d94",
         "amount":9.87,
         "hash":"5b1e4b1cf0a4c3d2e9f6a7b8c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192",
         "transactionDatetime":"2024-02-28 09:14:02",
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

جواب کے پیرامیٹرز

پیرامیٹر	تفصیل
id	UUID فارمیٹ میں ادائیگی کی ID
amount	کرپٹو کرنسی میں ادائیگی کی رقم
hash	آن چین ٹرانزیکشن کا ہیش
transactionDatetime	آن چین ٹرانزیکشن کی تاریخ اور وقت (UTC)
invoice	انوائس کے پیرامیٹرز والا آبجیکٹ۔ ادائیگی سے کوئی انوائس منسلک ہونے پر موجود ہوتا ہے
invoice.id	UUID فارمیٹ میں انوائس ID
invoice.uid	انوائس ID (گاہک کے لیے)
invoice.projectId	UUID فارمیٹ میں پروجیکٹ ID
invoice.createDatetime	انوائس بننے کی تاریخ اور وقت (UTC)
invoice.timeToPayDatetime	وہ تاریخ اور وقت جب تک انوائس درست رہتی ہے (UTC)
invoice.commissionFiatUSD	سروس فیس کی رقم۔ اس کا حساب invoice.amountFiatUSD کی رقم سے ہوتا ہے
invoice.amountFiatUSD	USD میں تبدیل شدہ انوائس کی رقم۔ انوائس بنتے وقت اس کا حساب invoice.amountFiat سے موجودہ شرح تبادلہ پر ہوتا ہے۔ ادائیگی کے لمحے سروس اسے اصل میں موصول ہونے والی رقم سے بدل دیتی ہے، جو اس لمحے کی شرح تبادلہ پر USD میں تبدیل ہوتی ہے۔ invoice.commissionFiatUSD میں فیس بھی اسی سے دوبارہ شمار ہوتی ہے
invoice.amountFiat	فیاٹ کرنسی میں انوائس کی اصل رقم۔ نہیں بدلتی
invoice.currencyFiat	فیاٹ کرنسی
invoice.description	انوائس بناتے وقت دی گئی تفصیل
invoice.serviceData	انوائس بناتے وقت دیا گیا سروس ڈیٹا
invoice.views	ادائیگی کے صفحے کے ویوز کی تعداد
invoice.status	انوائس کا اسٹیٹس
wallet	والٹ کے پیرامیٹرز والا آبجیکٹ
wallet.id	UUID فارمیٹ میں والٹ ID
wallet.name	والٹ کا نام
wallet.blockchain	کرپٹو والٹ کا بلاک چین
wallet.cryptocurrency	والٹ کی کرپٹو کرنسی
wallet.address	کرپٹو والٹ کا ایڈریس