# Список платежей

## Описание

Сервис автоматически ищет все платежи, поступающие на ваши крипто кошельки, но только в случае, если есть активные (неоплаченные) счета.

## Запрос

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

## Параметры запроса

<table data-full-width="true"><thead><tr><th width="182">Параметр</th><th width="128">Тип данных</th><th>Описание</th><th>Пример</th><th>Обязательный?</th><th>По умолчанию</th></tr></thead><tbody><tr><td><code>walletId</code></td><td>UUID</td><td>ID кошелька в формате UUID</td><td>1c48b092-9878-48f5-b441-07a8a48e7b54</td><td>нет</td><td></td></tr><tr><td><code>invoiceId</code></td><td>UUID</td><td>ID счета в формате UUID</td><td>1c48b092-9878-48f5-b441-07a8a48e7b54</td><td>нет</td><td></td></tr><tr><td><code>startDate</code></td><td>String</td><td>Начальная дата транзакции в блокчейне в формате Y-m-d</td><td>2000-01-01</td><td>нет</td><td></td></tr><tr><td><code>endDate</code></td><td>String</td><td>Конечная дата транзакции в блокчейне в формате Y-m-d</td><td>2030-01-01</td><td>нет</td><td></td></tr><tr><td><code>offset</code></td><td>Integer</td><td>Номер начальной записи, с которой начнется вывод данных</td><td>0</td><td>нет</td><td>0</td></tr><tr><td><code>limit</code></td><td>Integer</td><td>Количество записей, которые вы хотите получить</td><td>50</td><td>нет</td><td>10</td></tr></tbody></table>

## Пример ответа

```json
{
   "result":"success",
   "data":[
      {
         "id":"f986ad8d-2298-473d-982a-efbc817b975d",
         "amount":"12.00000000",
         "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.00", 
            "amountFiat":"12.00",
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"userId:2444",
            "views":0,
            "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.02000000",
         "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.00", 
            "amountFiat":"5.00",
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"userId:3419",
            "views":0,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}
```

## Параметры ответа

| Параметр                    | Описание                                                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `id`                        | ID платежа в формате UUID                                                                                     |
| `amount`                    | Сумма платежа в криптовалюте                                                                                  |
| `hash`                      | Хэш транзакции в блокчейне                                                                                    |
| `transactionDatetime`       | Дата и время транзакции в блокчейне (UTC)                                                                     |
| `invoice`                   | Раздел, содержащий параметры счета. Отображается в случае, если к платежу привязан счет                       |
| `invoice.id`                | ID счета в формате UUID                                                                                       |
| `invoice.uid`               | ID счета (для покупателя)                                                                                     |
| `invoice.projectId`         | ID проекта в формате UUID                                                                                     |
| `invoice.createDatetime`    | Дата и время создания счета (UTC)                                                                             |
| `invoice.timeToPayDatetime` | Дата и время, до которого действителен счет (UTC)                                                             |
| `invoice.commissionFiatUSD` | Сумма комиссии сервиса. Рассчитывается относительно суммы `invoice.amountFiatUSD`                             |
| `invoice.amountFiatUSD`     | Сумма в валюте USD, рассчитанная при создании счета по текущему курсу относительно суммы `invoice.amountFiat` |
| `invoice.amountFiat`        | Сумма в фиатной валюте                                                                                        |
| `invoice.currencyFiat`      | Валюта фиата                                                                                                  |
| `invoice.description`       | Описание, которое было задано при создании счета                                                              |
| `invoice.serviceData`       | Служебные данные, которые были заданы через API при создании счета                                            |
| `invoice.views`             | Количество просмотров платежной страницы                                                                      |
| `invoice.status`            | Статус счета                                                                                                  |
| `wallet`                    | Раздел, содержащий параметры кошелька. Отображается в случае, если к платежу привязан счет                    |
| `wallets.id`                | ID кошелька в формате UUID                                                                                    |
| `wallets.name`              | Название кошелька                                                                                             |
| `wallets.blockchain`        | Блокчейн крипто кошелька                                                                                      |
| `wallets.cryptocurrency`    | Криптовалюта кошелька                                                                                         |
| `wallets.address`           | Адрес крипто кошелька                                                                                         |