Часто задаваемые вопросы
Виджет приема оплаты
Вы можете установить в свой проект виджет для приема оплаты за товары или услуги с помощью сервиса Bitbanker.
Есть три типа виджетов:
Покупатель вводит свой email и сумму оплаты. Этот виджет подходит для интернет-магазинов или услуг без фиксированной стоимости и авторизации пользователя, когда вы не можете или не хотите собирать данные пользователя.
Покупатель вводит только сумму. Подходит для установки в ЛК пользователя. Для отображения email-адреса в инвойсе нужно предустановить подгрузку payer_email.
Кнопка «Оплатить». Подходит для установки в ЛК пользователя рядом с товаром или услугой с фиксированной стоимостью. Для отображения email-адреса в инвойсе также нужно предустановить подгрузку payer_email.
Как установить виджет
Пример установки: https://codepen.io/Bitbanker/pen/MWLgGjR
Установите в секцию <head></head> вашего сайта:
<script src="https://widgets.bitbanker.org/acquiring.js"></script>
На месте установки виджета вставьте html-код и заполните параметры:
<acquiring-widget api-key="API_KEY" amount="AMOUNT" email="EMAIL" direction="DIRECTION" lang="ru" source="SOURCE" currency="CURRENCY" payment-currencies="PAYMENT_CURRENCIES" payer="PAYER"></acquiring-widget>
Какие параметры можно добавить в виджет
Обязательные
amount: "2000" // сумма счета. Если указывать сумму заранее не надо, то оставьте поле пустым — amount=””
"api-key": "xxxxx" // ваш API находится на странице https://app.bitbanker.org/profile/api
source: "xxx" // источник, название виджета
lang: "ru" // язык виджета — "ru"| "en", default -"ru"
Дополнительные
email: "name@gmail.com" // email плательщика
direction: "row" // визуальная ориентация виджета "row" или "columm", default — columm
language: "ru" // язык счета, который получит ваш клиент — "ru"| "en", default -"ru"
currency: "RUB" // в этой валюте выставляется счет. Возможные значения: BTC, ETH, USDT, USDC, TRX, ATOM, AVAX, RUB.R, default — "RUB.R"
view: "full" // режим отображения виджета, "full" — поле с почтой и суммой, кнопка оплаты | "amount"— поле с суммой и кнопка оплаты | "button"— только кнопка оплаты, default — "full"
"button-text": "Pay" // текст кнопки оплаты, default - "Оплатить/Pay"
description: "консультация" // за какой товар/услугу получаете оплату. Текстовое поле в стороке "Оплата за" на странице счета
header: "Онлайн-школа" // ваши данные, кто выставляет счет, поле в строке "Счет от" на странице счета
"payment-currencies": "BTC, USDT" // криптовалюта, которой оплачивается счет. Возможные значения: BTC, ETH, USDT, USDC, TRX, ATOM, AVAX. default - "BTC, ETH, USDT"
payer: "name" // кому вы выставляете счет, поле в строке "Счет для" на странице счета
Вы можете выставлять счет только в определенных сетях, если эти сети подключены для пополнения счета в Bitbanker. Проверить актуальные сети можно в разделе «Пополнение и вывод».
ключ:значение
"payment_chains": ["bsc", "tron", "eth", "avax", "ton"]
Чтобы в виджете была доступна оплата по СБП, необходимо ввести дополнительную переменную sbp-payment.