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

## Описание

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

## Запрос

```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`           | Адрес крипто кошелька                                                                                         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitsby.app/ru/dokumentaciya-api/spisok-platezhei.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.