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="{"userId":100,"orderId":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¤cyFiat=EUR&timeToPay=6&description=12 months license for BITSBY&serviceData={"userId":100,"orderId":500}&output=errors
Ключ безопасности
Используется для проверки актуальности формы. В случае, если будет указана неверная комбинация ключа безопасности и ID проекта - пользователь получит ошибку создания счета.
Для чего нужен ключ безопасности? В случае, если для вас стал неактуален метод создания счетов по HTML формам и ссылкам - вы просто генерируете в настройках проекта новый ключ безопасности и все формы и ссылки на сайтах перестают работать (создавать счета).
Webhook и уведомления
Счета, создаваемые этим методом идентичным счетам, созданным через личный кабинет или API. Соответственно при оплате этих счетов сработают все уведомления, которые были настроены в проекте.
Last updated