قائمة الدفعات

نظرة عامة

تجد الخدمة تلقائيًا كل الدفعات الواردة إلى محافظك المشفرة، لكن فقط ما دامت هناك فواتير ببحث نشط. يعمل البحث ما دامت الفاتورة غير مدفوعة، ويستمر ساعة إضافية بعد مهلة الدفع — مراعاةً للشبكات البطيئة. وإذا لم توجد فواتير كهذه، لا تدخل المعاملة الواردة إلى النظام.

الطلب

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	1c48b092-9878-48f5-b441-07a8a48e7b54	لا
invoiceId	UUID	معرّف الفاتورة بصيغة UUID	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"
         }
      }
   ]
}

الدفعة التي وجدتها الخدمة لكن لم تربطها بفاتورة بعد تأتي من دون كائن الفاتورة. هذه الدفعات هي المرشحة للربط اليدوي:

{
   "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
amount	مبلغ الدفعة بالعملة المشفرة
hash	hash المعاملة على السلسلة
transactionDatetime	تاريخ ووقت المعاملة على السلسلة (UTC)
invoice	كائن بمعطيات الفاتورة. يظهر إذا رُبطت فاتورة بالدفعة
invoice.id	معرّف الفاتورة بصيغة UUID
invoice.uid	معرّف الفاتورة (للمشتري)
invoice.projectId	معرّف المشروع بصيغة UUID
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
wallet.name	اسم المحفظة
wallet.blockchain	بلوكتشين المحفظة المشفرة
wallet.cryptocurrency	العملة المشفرة للمحفظة
wallet.address	عنوان المحفظة المشفرة