Payment acceptance widget
Last updated
Last updated
The widget allows you to set up payment acceptance with minimal integration. On your part, you will need to configure the reception of webhooks and place the widget on your application page.
Depending on the selected type of payment acceptance, we will send the appropriate type of webhook
Webhook when paying an invoice Webhook when adding funds to a personal address
Orphan transaction webhook. In order to handle cases of sending a payment with the wrong currency, contact your personal manager to issue a webhook about the orphan transaction
For each new payment, the user receives a new invoice with a unique address that is valid for a limited time. The invoice can be issued in crypto or fiat currency, with a fixed amount or without it for free payment.
Payment acceptance allows you to create a list of crypto addresses for each payer. These addresses are permanently assigned to the user.
The connection is made using the HTML tag <iframe/>
Example:
The attribute
allow="clipboard-read; clipboard-write"
is required so that your customers can copy the payment address by clicking the "Copy" button
The parameters are passed to the query
To insert data into the
query
, it must be escaped. In JavaScript, this can be done using the functionencodeURIComponent
const payinCryptoInvoiceId = encodeURIComponent('#12345');
If you do not pass the
payinCryptoInvoiceCurrencies
parameter, the user will be prompted choose from all available currencies to recalculate its amountMultiple currencies can be separated by commas in the parameter, then the user will be offered a choice only from the specified currencies
One currency can be transferred, then it will be selected, without the possibility for the user to change
The
payinCryptoInvoiceAmount
parameter will work if one currency is passed topayinCryptoInvoiceCurrencies
You can specify multiple coins/networks separated by commas in the parameter
Only the ticker of the coin is available, in this case all networks that have this coin will be available Example:
USDT,BNB,ETH
It is possible to specify the coin in a specific network, the separator is an underscore Example:
USDT_tron,BNB_bsc,ETH_ethereum
The personal users created from the widgets will be isolated between the widgets
If you get the payment address for the user X from the widget A, it will not be the same as for the same user X from the widget B
If you want to get a user X through the Personal payment API, then you must add the widget ID to the beginning
User X:
user12345
Widget ID:00000000-0000-0000-0000-000000000000
Client ID to receive via API will be:
00000000-0000-0000-0000-000000000000@user12345
Parameter | Example | Description |
---|---|---|
Parameter | Example | Description |
---|---|---|
payinCryptoInvoiceAmount
(decimal) 123.45
Amount to be paid
payinCryptoInvoiceCurrencies
(string) USD,EUR
Currency to be converted
payinCryptoInvoiceId
(string) #12345
Payment ID
payinCryptoInvoiceDesc
(string) Payment payment 12345
Payment description
payinCryptoCurrenciesTo
(string) USDT_bsc,BNB,USDD_tron
List of coins available for payment
extUserId
(string) user1234567
Merchant's payer ID (required parameter)