# HTML формы и ссылки

HTML формы и ссылки являются одним из методов создания новых счетов.

Используется как простой и самый быстрый способ добавления оплаты криптовалютой на сайтах, интернет-магазинах и в ботах.

Способ имеет одно ограничение: таким образом можно создать одновременно не более 50 активных (неоплаченных) счетов.

## HTML формы

Поместите следующую HTML структуру формы в любое место на странице, где вы хотите отобразить кнопку оплаты:

<pre class="language-html"><code class="lang-html">&#x3C;form method="post" action="https://dash.bitsby.app/invoices/createFromForm">
<strong>  &#x3C;input type="hidden" name="securityKey" value="e54mc20bzkrf9evty">
</strong>  &#x3C;input type="hidden" name="projectId" value="9deea1e2-0c08-41a3-bdc2-a34eada3892d">
  &#x3C;input type="hidden" name="amountFiat" value="10.55">
  &#x3C;input type="hidden" name="currencyFiat" value="EUR">
  &#x3C;input type="hidden" name="timeToPay" value="6">
  &#x3C;input type="hidden" name="description" value="12 months license for BITSBY">
  &#x3C;input type="hidden" name="serviceData" value="{&#x26;quot;userId&#x26;quot;:100,&#x26;quot;orderId&#x26;quot;:500}">
  &#x3C;input type="hidden" name="output" value="errors">
  &#x3C;input type="submit" value="Pay">
&#x3C;/form>
</code></pre>

Вы можете декорировать кнопку Pay в любой формат под дизайн своей страницы используя CSS стили.

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

<table data-full-width="true"><thead><tr><th>Параметр</th><th>Тип данных</th><th>Описание</th><th>Пример</th><th>Обязательный?</th></tr></thead><tbody><tr><td><code>securityKey</code></td><td>String</td><td>Ключ безопасности из настроек проекта</td><td>e54mc20bzkrf9evty</td><td>да</td></tr><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>timeToPay</code></td><td>Integer</td><td>Время в часах на оплату счета. Допустимые значения: 0.5, 1, 3, 6, 12</td><td>6</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>output</code></td><td>String</td><td><p>Используется для отладки формы. Если установить этот параметр, тогда будут выводится детальная информация об ошибках.</p><p>В рабочем режиме данный параметр использовать нельзя.<br>Допустимые значения: errors</p></td><td>errors</td><td>нет</td></tr></tbody></table>

## Ссылки

Ссылку для создания счета удобно использовать в чат ботах, передавать другим пользователям в чатах. Но также можно использовать и на обычных страницах.

Ссылка использует все те-же параметры, что и HTML форма. Пример:

```html
https://dash.bitsby.app/invoices/createFromForm?securityKey=e54mc20bzkrf9evty&projectId=9deea1e2-0c08-41a3-bdc2-a34eada3892d&amountFiat=10.55&currencyFiat=EUR&timeToPay=6&description=12 months license for BITSBY&serviceData={"userId":100,"orderId":500}&output=errors
```

## Ключ безопасности

Используется для проверки актуальности формы. В случае, если будет указана неверная комбинация ключа безопасности и ID проекта - пользователь получит ошибку создания счета.

Для чего нужен ключ безопасности? В случае, если для вас стал неактуален метод создания счетов по HTML формам и ссылкам - вы просто генерируете в настройках проекта новый ключ безопасности и все формы и ссылки на сайтах перестают работать (создавать счета).

## Webhook и уведомления

Счета, создаваемые этим методом идентичным счетам, созданным через личный кабинет или API. Соответственно при оплате этих счетов сработают все уведомления, которые были настроены в проекте.


---

# 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/sozdanie-schetov/html-formy-i-ssylki.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.