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

## جائزہ

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

## درخواست

```bash
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      |

## جواب کی مثال

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

```json
{
   "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 آبجیکٹ کے بغیر آتی ہے۔ یہی ادائیگیاں دستی طور پر منسلک کرنے کی امیدوار ہیں:

```json
{
   "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`            | کرپٹو والٹ کا ایڈریس |