Создание счета

Запрос

curl -X POST https://api.bitsby.app/invoices/create \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "projectId=9deea1e2-0c08-41a3-bdc2-a34eada3892d" \
	-F "amountFiat=10.55" \
	-F "currencyFiat=EUR" \
	-F "description=12 months license for BITSBY" \
	-F "serviceData={\"userId\":100,\"orderId\":500}" \
	-F "timeToPay=6"

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

Параметр	Тип данных	Описание	Пример	Обязательный?
projectId	UUID	ID проекта в формате UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	да
amountFiat	Float	Сумма в фиатной валюте	10.55	да
currencyFiat	String	Валюта фиата. Допустимые значения: USD, EUR, RUB	EUR	да
description	String	Описание товара или услуги. Отображается покупателю на платежной странице	Лицензия на 12 месяцев для BITSBY	нет
serviceData	String	Служебные данные. НЕ отображается покупателю. При оплате счета передается в webhook URL магазина. Эти данные используются для связи счета и платежа с покупателем в интернет магазине продавца. Удобно использовать данные в формате JSON	{"userId":100,"orderId":500}	нет
timeToPay	Integer	Время в часах на оплату счета. Допустимые значения: 0.5, 1, 3, 6, 12	1	да

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

{
   "result":"success",
   "data":{
      "id":"ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c",
      "uid":"MXNj4m8HhcM4",
      "createDatetime":"2024-02-29 15:20:24",
      "timeToPayDatetime":"2024-03-01 03:20:24",
      "commissionFiatUSD":"0.10",
      "amountFiatUSD":"10.00",
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4",
      "wallets":[
         {
            "id":"c27b0847-40c9-4f1e-87f5-9c3d4999dfc1",
            "name":"usdt-bnb",
            "blockchain":"bnbSmartChain",
            "cryptocurrency":"usdt",
            "address":"0x1427ca2c71bCa28f0B619b70E3F112065D5411aC",
            "amountCrypto":"11.45000000"
         },
         {
            "id":"a4c9e2ee-9a03-43e5-a1a1-00caf679d16a",
            "name":"usdt-ethereum",
            "blockchain":"ethereum",
            "cryptocurrency":"usdt",
            "address":"0x1427ca2c71bCa28f0B619b70E3F112065D5411aC",
            "amountCrypto":"11.45000000"
         },
         {
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7",
            "amountCrypto":"11.45000000"
         },
         {
            "id":"d7169f3a-f354-4f84-b85e-cf63e0a53367",
            "name":"ethereum",
            "blockchain":"ethereum",
            "cryptocurrency":"eth",
            "address":"0x1427ca2c71bCa28f0B619b70E3F112065D5411aC",
            "amountCrypto":"0.00329601"
         },
         {
            "id":"dee35e92-a2e2-4b12-be8c-e5505c62f1d6",
            "name":"btc",
            "blockchain":"bitcoin",
            "cryptocurrency":"btc",
            "address":"bc1qd9hs6dal8k2x0l8zhsgywqyvn9tpj3mrkk430t",
            "amountCrypto":"0.00018186"
         }
      ]
   }
}

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

Параметр	Описание
id	ID счета в формате UUID
uid	ID счета (для покупателя)
createDatetime	Дата и время создания счета (UTC)
timeToPayDatetime	Дата и время, до которого действителен счет (UTC). До этой даты покупатель должен успеть оплатить счет
commissionFiatUSD	Сумма комиссии сервиса. Рассчитывается относительно суммы invoice.amountFiatUSD
amountFiatUSD	Сумма в валюте USD, рассчитанная при создании счета по текущему курсу относительно суммы invoice.amountFiat
url	Ссылка на платежную страницу для покупателя. Эту ссылку надо передать покупателю для оплаты счета
wallets	Список ваших крипто кошельков с зарезервированными суммами. В период действия счета сервис будет проверять поступающие транзакции на указанные адреса крипто кошельков с соответствующими суммами
wallets.id	ID кошелька в формате UUID
wallets.name	Название кошелька
wallets.blockchain	Блокчейн крипто кошелька
wallets.cryptocurrency	Криптовалюта кошелька
wallets.address	Адрес крипто кошелька
wallets.amountCrypto	Зарезервированная (ожидаемая) cумма платежа в криптовалюте