Виджет приема оплаты
Last updated
Last updated
Виджет позволяет настроить прием платежей с минимальной интеграцией. С вашей стороны необходимо будет настроить прием вебхуков и разместить виджет на странице своего приложения.
В зависимости от выбранного типа приема платежей, мы будем отправлять соответствующий тип вебхука
Вебхук при оплате счета Вебхук при пополнении персонального адреса
Вебхук сиротской транзакции. Для того, чтобы обработать случаи отправки платежа с неправильной валютой, обратитесь к персональному менеджеру для выставления вебхука о сиротской транзакции
Для каждого нового платежа пользователь получает новый счет с уникальным адресом, который действует ограниченное время. Счет может быть выставлен в крипто или фиатной валюте, с фиксированной суммой или без нее для свободной оплаты.
Прием платежей позволяет формировать список крипто адресов под каждого плательщика. Эти адреса навсегда закрепляются за пользователем.
Через виджет можно осуществляй выплаты.
Подключение происходит при помощи HTML-тега <iframe/>
Пример:
Атрибут
allow="clipboard-read; clipboard-write"необходим чтобы ваши клиенты могли скопировать адрес платежа нажатием кнопки "Скопировать"
Параметры передаются в query
Для вставки данных в
queryих необходимо экранировать. В JavaScript это можно сделать с помощью функцииencodeURIComponentconst payinCryptoInvoiceId = encodeURIComponent('#12345');
| Параметр | Пример | Описание |
|---|---|---|
payinCryptoInvoiceAmount | (decimal) | Сумма к оплате |
payinCryptoInvoiceCurrencies | (string) | Валюта к пересчету |
payinCryptoInvoiceId | (string) | Идентификатор платежа |
payinCryptoInvoiceDesc | (string) | Описание платежа |
payinCryptoCurrenciesTo | (string) | Список монет доступных для оплаты |
Если не передать параметр
payinCryptoInvoiceCurrencies, то пользователю будет предложен выбор из всех доступных валют для пересчета его суммыВ параметр можно передать несколько валют через запятую, тогда пользователю будет предложен выбор только из указанных валют
Можно передать одну валюту, тогда она будет выбрана, без возможности для смены пользователем
Параметр
payinCryptoInvoiceAmountбудет работать если вpayinCryptoInvoiceCurrenciesпередана одна валюта
В параметр можно указывать несколько монет/сетей через запятую
Доступно указание только тикера монеты, в таком случае будут доступны все сети, в которых эта монета есть Пример:
USDT,BNB,ETHДоступно указание монеты в конкретной сети, разделитель - нижнее подчеркивание Пример:
USDT_tron,BNB_bsc,ETH_ethereum
При указании параметр
payinCryptoInvoicePayerEmailRequired=trueполеpayinCryptoInvoicePayerEmailAllowигнорируется
| Параметр | Пример | Описание |
|---|---|---|
extUserId | (string) | ID плательщика на стороне мерчанта (параметр обязательный) |
Создаваемые персональные пользователи из виджетов будут изолированны между виджетами
Если получить адрес оплаты для пользователя X из виджета A, то он не будет таким же как для того же пользователя X из виджета B
Если вы хотите получить пользователя X через API персональных платежей, то вы должны добавить ID виджета в начало
Пользователь X:
user12345ID виджета:00000000-0000-0000-0000-000000000000ID клиента для получения через API будет таким:
00000000-0000-0000-0000-000000000000@user12345