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

Запрос

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=12"

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

Параметр	Тип данных	Описание	Пример	Обязательный?
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	Идентификатор заказа на стороне магазина. Не отображается покупателю. Эти данные используются для связи счета и платежа с покупателем в интернет магазине продавца. Удобно использовать данные в формате JSON	{"userId":100,"orderId":500}	нет
timeToPay	Float	Время в часах на оплату счета. Допустимые значения: 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.1,
      "amountFiatUSD":10,
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4"
   }
}

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

Параметр	Описание
id	ID счета в формате UUID
uid	ID счета (для покупателя)
createDatetime	Дата и время создания счета (UTC)
timeToPayDatetime	Дата и время, до которого действителен счет (UTC). До этой даты покупатель должен успеть оплатить счет
commissionFiatUSD	Сумма комиссии сервиса. Рассчитывается относительно суммы amountFiatUSD
amountFiatUSD	Сумма в валюте USD, рассчитанная при создании счета по текущему курсу относительно суммы invoice.amountFiat
url	Ссылка на платежную страницу для покупателя. Эту ссылку надо передать покупателю для оплаты счета