HTML forms and links

HTML forms and links are one of the methods to create new invoices.

It is used as the easiest and fastest way to add cryptocurrency payments on websites, online stores and bots.

The method has one limitation: no more than 50 active (unpaid) invoices can be created this way at a time.

HTML forms

Place the following HTML form structure anywhere on the page where you want to display the payment button:

<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>

You can decorate the Pay button in any format to fit your page design using CSS styles.

Form parameters

Parameter	Data type	Description	Example	Mandatory?
securityKey	String	Security key from project settings	e54mc20bzkrf9evty	yes
projectId	UUID	Project ID in UUID format	1c48b092-9878-48f5-b441-07a8a48e7b54	yes
amountFiat	Float	Amount in fiat currency	10.55	yes
currencyFiat	String	Currency of fiat. Valid values: USD, EUR, RUB	EUR	yes
timeToPay	Integer	Time in hours for invoice payment. Valid values: 0.5, 1, 3, 6, 12	6	yes
description	String	Description of the product or service. Displayed to the buyer on the payment page	12 months license for BITSBY	no
serviceData	String	Service data. NOT displayed to the buyer. When paying the invoice, it is passed to the webhook URL of the store. This data is used to link the invoice and payment to the buyer in the merchant's webhook. It is convenient to use data in JSON format	{"userId":100,"orderId":500}	no
output	String	Used for debugging the form. If this parameter is set, then detailed information about errors will be output. This parameter cannot be used in working mode. Valid values: errors	errors	no

Links

Links The link for invoice creation is convenient to use in chat bots, to pass to other users in chat rooms. But it can also be used on regular pages.

The link uses all the same parameters as HTML form. Example:

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

Security Key

It is used to check if the form is up to date. If an incorrect combination of security key and project ID is specified, the user will receive an invoice creation error.

Why do I need a security key? In case the method of creating invoices by HTML forms and links has become irrelevant for you - you just generate a new security key in the project settings and all forms and links on the sites stop working (creating invoices).

Webhook and notifications

Invoices created by this method are identical to invoices created via personal cabinet or API. Accordingly, when these invoices are paid, all notifications that were configured in the project will be triggered.