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

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

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

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

HTML формы

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

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

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

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

Параметр	Тип данных	Описание	Пример	Обязательный?
securityKey	String	Ключ безопасности из настроек проекта	e54mc20bzkrf9evty	да
projectId	UUID	ID проекта в формате UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	да
amountFiat	Float	Сумма в фиатной валюте	10.55	да
currencyFiat	String	Валюта фиата. Допустимые значения: USD, EUR, RUB	EUR	да
timeToPay	Integer	Время в часах на оплату счета. Допустимые значения: 0.5, 1, 3, 6, 12	6	да
description	String	Описание товара или услуги. Отображается покупателю на платежной странице	Лицензия на 12 месяцев для BITSBY	нет
serviceData	String	Служебные данные. НЕ отображается покупателю. При оплате счета передается в webhook URL магазина. Эти данные используются для связи счета и платежа с покупателем в интернет магазине продавца. Удобно использовать данные в формате JSON	{"userId":100,"orderId":500}	нет
output	String	Используется для отладки формы. Если установить этот параметр, тогда будут выводится детальная информация об ошибках. В рабочем режиме данный параметр использовать нельзя. Допустимые значения: errors	errors	нет

Ссылки

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

Ссылка использует все те-же параметры, что и 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. Соответственно при оплате этих счетов сработают все уведомления, которые были настроены в проекте.