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

## Запрос

```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=6"
```

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

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

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

```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.10",
      "amountFiatUSD":"10.00",
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4",
   }
}
```

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

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