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

## Запрос

```bash
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                                    | да            |

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

```json
{
   "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`               | Ссылка на платежную страницу для покупателя. Эту ссылку надо передать покупателю для оплаты счета             |