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

Описание

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

Запрос

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	ID кошелька в формате UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	нет
invoiceId	UUID	ID счета в формате 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.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	Адрес крипто кошелька