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

## Запрос

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitsby.app/ru/dokumentaciya-api/sozdanie-scheta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.