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

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

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

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

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

Код примера

<script src="https://widget.unitpay.money/unitpay.js"></script>
                        <script type="text/javascript">
                              this.pay = function() {
                                      var payment = new UnitPay();
                                      payment.createWidget({
                                            publicKey: "123456-a875a",
                                            sum: 1,
                                            account: "demo",
                                            domainName: "unitpay.money",
                                            signature: "4e7c6bf0ba9cc45eef708d0054a0ef8baee8017bf4385b9689999e92909f683f",
                                            desc: "Описание платежа",
                                            locale: "en",
                                      });
                                      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 абонента или номер заказа)

desc

строка

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

domainName

строка

unitpay.money

signature

строка

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

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

Значение

Описание

paymentType

строка

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

locale

ru, en

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

currency

строка

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

hideMenu

true, false

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

Если возникнут какие-то дополнительные вопросы по ходу интеграции, вы можете задать их службе поддержки.

Last updated