Создание платежа (виджет)

Виджет - это всплывающее окно с формой оплаты.

Для использования виджета вам достаточно добавить его код на страницу сайта, настроить передачу параметров и создать событие его вызова (например, нажатие на кнопку).

Код примера и описание используемых параметров виджета расположены в личном кабинете Unitpay в настройках проекта на вкладке "Виджет оплаты" (на скриншоте ниже).

Расположение кода виджета в настройках проекта

Код примера:

<script src="https://widget.unitpay.money/unitpay.js"></script>
<script type="text/javascript">
this.pay = function() {
var payment = new UnitPay();
payment.createWidget({
publicKey: "PUBLIC KEY",
sum: 1,
account: "demo",
domainName: "unitpay.money",
signature: "2c38bb3114b2f02222ee35f6b60c6bbe628ad31bed59633787204ae59659a02e",
desc: "Описание платежа",
locale: "ru",
});
payment.success(function (params) {
console.log('Успешный платеж');
});
payment.error(function (message, params) {
console.log(message);
});
return false;
};
</script>

Обязательные параметры:

Значение

Описание

publicKey

строка

Публичный ключ проекта (PUBLIC KEY)

sum

число

Сумма платежа (например, 10.00);

account

строка

Идентификатор абонента в вашей системе (например, email абонента или номер заказа)

domainName

строка

unitpay.money

signature

строка

Цифровая подпись запроса. Они защищает вас от злоумышленников - подмены описания или стоимости заказа, размещения ссылки на оплату на ресурсах мошенников. Образуется как sha256( account + "{up}" + currency + "{up}" + desc + "{up}" + sum + "{up}" + secretKey), где sha256 - метод хеширования; "{up}" - разделитель параметров в хеш-функции; secretKey - секретный ключ проекта (доступен в личном кабинете) Важно! Если вы не передаете currency на форму оплаты, то этот параметр не должен участвовать в формировании подписи.

desc

строка

Описание заказа для покупателя

Дополнительные параметры:

Значение

Описание

locale

ru, en

Принудительное назначение языка виджета.

currency

строка

Валюта суммы оплаты по ISO 4217 (RUB, UAH, BYN, EUR, USD, например, подробнее - тут. Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту по умолчанию.

paymentType

строка

Код платежной системы, через которую будет идти оплата.

hideMenu

true, false

Скрывает меню с выбором способов оплаты.

Если возникнут какие-то дополнительные вопросы по ходу интеграции, вы можете задать их в чате Юнит.Помощь или адресовать вопрос на [email protected]