Unitpay
ru
ru
  • Главная
  • Начало работы
    • Регистрация
    • Добавление проекта
      • Добавление сообщества VK
      • Добавление канала / супергруппы Telegram
    • Модерация проекта
      • Помощник по модерации
    • Перенос проекта
  • Платежи
    • Создание платежа (простой способ)
    • Создание платежа
    • Создание платежа (виджет)
    • Создание ссылок на оплату в личном кабинете
    • Обработчик платежа
    • Информация о платеже
    • Возврат платежа
    • Двухстадийные платежи (платежи с преавторизацией)
    • Подписки API
      • Создание подписки
      • Получение списка активных подписок
      • Получение информации о подписке
      • Закрытие подписки
  • Массовые выплаты
    • Создание выплаты
    • Информация о выплате
    • Информация о карте по BIN
    • Информация о комиссии на выплаты
    • Дополнительно: выплаты на основе CSV-реестра
    • Получение справочника банков-участников СБП (API)
    • Автовыплаты
  • Онлайн-кассы
    • Юнит.Чеки
    • Подключение Онлайн-кассы
    • Параметры для формирования чека
    • Типы позиций для формирования чека
    • Просмотр чека
    • Чек зачета аванса
  • Готовые модули
    • Unitpay SDK
    • Базовый обработчик платежа
    • CMS модули
      • 1C Bitrix
      • Amiro CMS
      • AmoCRM
      • BILLmanager
      • Bitrix24
      • CMS NWICODE
      • CMS-S3
      • CS-Cart
      • DIAFAN.CMS
      • Drupal 8, 9 (commerce)
      • Drupal 7 (ubercart 3)
      • Drupal 7 (commerce)
      • Ecwid от Lightspeed
      • HostCMS
      • InSales
      • Joomshopping 4 (joomla 3)
      • LogicBoxes
      • MODX (miniShop2)
      • Magento
      • Magento 2
      • Netcat CMS
      • OpenCart
      • osCommerce
      • PHPShop
      • Prestashop
      • RetailCRM
      • ReadyScript
      • SellerGames
      • Senler
      • Simpla
      • ShopCMS
      • Tilda
      • Taplink
      • UMI.CMS
      • UCoz
      • VamShop 2
      • Virtuality CMS
      • VirtueMart 3 (joomla 3)
      • Webasyst Shop Script 7 (8)
      • Wix
      • Zen Cart
  • Личный кабинет
    • Telegram бот
    • Инструкция по интерфейсу
      • Регистрация юридических лиц
      • Новый проект и модерация
      • Настройка проекта и прием платежей
      • Подключение стран
      • Выплаты
      • Онлайн-кассы и «Юнит.Чеки»
      • Документы и отчетность
      • Роли и сотрудники
    • Пакет документов для ИП
    • Пакет документов для ООО
    • Смена расчётного счета для выплат
    • Текущий баланс (API)
    • Комиссии проекта (API)
    • Курсы конвертации валют (API)
    • Способы оплаты на проекте (API)
  • Справочник
    • IP адреса системы
    • Коды платежных систем
    • Статусы и ошибки платежей
    • Внешний вид формы оплаты
    • Буквенные коды валют
  • Реферальная программа
    • Интерфейс кабинета реферера (агента)
  • Другие возможности
    • Использование тестового API
    • Получение информации по BIN карты
    • Темная тема
  • Служба поддержки
  • FAQ
    • Как перейти на ИП с физического лица
    • Регистрация юр. лица или ИП
    • Модерация проекта
    • Интеграция платежного решения
    • Прием платежей
    • Возврат платежей
    • Выплаты юр. лицам
    • Массовые выплаты
    • Онлайн-кассы
    • Юридические вопросы
    • Чеки
  • Обновления
Powered by GitBook
On this page

Was this helpful?

  1. Платежи

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

PreviousСоздание платежаNextСоздание ссылок на оплату в личном кабинете

Last updated 5 days ago

Was this helpful?

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

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

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

Код примера:

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

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

publicKey

строка

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

account

строка

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

sum

число

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

desc

строка

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

domainName

строка

unitpay.ru

signature

строка

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

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

currency

строка

Валюта суммы оплаты, допустимые значения: "RUB", "UAH", "BYR", "EUR", "USD" (по умолчанию RUB). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту по умолчанию.

locale

ru, en

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

paymentType

строка

subscription

true

subscriptionId

число

preauth

0,1

preauthExpireLogic

число

Поле для логики блокировки платежей с преавторизацией:

0 - При отсутствии запроса на подтверждение или отмену, платеж по истечении срока блокировки на стороне банка-эквайера (~114 часов после создания платежа) будет подтвержден;

1 - При отсутствии запроса на подтверждение или отмену, платеж по истечении срока блокировки на стороне банка-эквайера (~114 часов после создания платежа) будет отменен.

Если параметр не будет использован, платеж будет отменен по истечении срока.

hideMenu

true, false

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

hideOtherMethods

true, false

Скрывает окно выбора других способов оплаты

Если вы подключили онлайн-кассу в личном кабинете Unitpay, то для формирования чеков необходимо дополнительно передать ряд параметров:

cashItems

строка

Может быть сформирован, как в примере или следующими способами: btoa(unescape(encodeURIComponent(JSON.stringify([{"name":"Шаверма", "count": 1, "price":10.00, "type":"commodity"}])))) ________________________

const cashItems = [{ name: 'Shaverma', count: 1, price: this.amount, type: 'commodity' }]; btoa(JSON.stringify(cashItems))

customerEmail

строка

Электронная почта клиента, на которую будет отправлен чек

customerPhone

строка

Телефон плательщика в международном формате без "+" (чек на него не будет отправлен)

, через которую будет идти оплата.

Используйте данный флаг, если требуется создать подписку по карте плательщика. Идентификатор подписки (subscriptionId) будет передан в методе PAY на ваш . Использование подписок возможно только после согласования со Службой безопасности Unitpay.

Идентификатор , по которой требуется произвести списание средств. Данный параметр должен быть предварительно получен в методе PAY на ваш

Используйте этот флаг для создания платежа с , по умолчанию флаг выключен и значение равно 0

Подробнее

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