> For the complete documentation index, see [llms.txt](https://docs.bitsby.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bitsby.app/ru/sozdanie-schetov/html-formy-i-ssylki.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.bitsby.app/ru/sozdanie-schetov/html-formy-i-ssylki.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.