Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

FireKassa Card/Link

Если вам необходимо обновить модуль на сервере - воспользуйтесь инструкцией

С версии 2.7.1 мерчанты FireKassa Card и FireKassa Link заменены одним мерчантом FireKassa. Создайте новый мерчант по этой инструкции и подключите его к направлениям вместо старых. Старые мерчанты оставьте включенными, пока по ним не завершатся все заявки.

Настройки в личном кабинете мерчанта

Пройдите регистрацию на сайте Vanilapay (при работе с RUB) или на сайте Gamepay (при работе с UAH).

Зайдите в личный кабинет, раздел "Сайты" -> "Список сайтов" и добавьте новый сайт.

Заполните указанные поля, кроме "URL уведомлений" и "URL уведомлений для выплат" и нажмите "Добавить".

В открывшемся окне перейдите на вкладку "API".

Обновите API Bearer Token и API Sign Token, нажав "Изменить" на каждой строке поочередно.

Скопируйте ключи и сохраните их в текстовый файл.

Настройки модуля

В панели администратора создайте нового мерчанта в разделе "Мерчанты" -> "Добавить мерчант".

Выберите FireKassa в выпадающем списке в поле «Модуль», укажите название для модуля и нажмите «Сохранить».

Заполните указанные авторизационные поля.

Домен — оставьте пустым при работе с RUB (используется https://admin.vanilapay.com). При работе с UAH укажите https://admin.gampay.cc.

API ключ — API Bearer Token из личного кабинета Firekassa

Секретный ключ — API Sign Token из личного кабинета Firekassa

Для обоих типов мерчанта действуют лимиты на стороне FireKassa — уточните их у технической поддержки FireKassa.

Тип мерчанта

В настройках модуля доступно два варианта работы:

Payment link — в заявке выводится кнопка перехода на платежную форму FireKassa. Форма показывает все способы оплаты, подключенные в вашем личном кабинете для валюты заявки.

Requisites — реквизиты на оплату (номер карты или номер телефона для СБП) и получатель выдаются прямо в заявке.

Тип мерчанта можно изменить, пока по этой копии модуля нет заявок. После первой заявки он фиксируется — для другого типа создайте отдельную копию модуля.

Особые поля

Поля появляются в блоке «Другие настройки» после сохранения ключей.

Способ оплаты:

  • Автоматически — способ определяется по полю «Обозначение для XML» валюты «Отдаете»: карта для CARDRUB, SBERRUB и других карточных обозначений, СБП для SBPRUB. Полный список соответствий приведен в подсказке «Автоматически». Если обозначения нет в списке, выберите способ вручную или через доп.поле.

  • Доп.поля (Валюты) — использование дополнительного поля валюты.

  • Доп.поля (Направление) — использование дополнительного поля направления обмена.

  • Способ оплаты — ручной выбор из способов, включенных в вашем личном кабинете.

Кошелек — счет зачисления в личном кабинете FireKassa:

  • Автоматически — первый подключенный счет в валюте заявки, на котором включен выбранный способ оплаты.

  • Доп.поля (Валюты), Доп.поля (Направление) — как для способа оплаты.

  • Кошелек — ручной выбор счета.

Значения доп.поля должны содержать код из подсказки к настройке, например Card (card), SBP (sbp-a) или Рубли (sber). Можно указать только код.

Кнопка оплаты и QR-код

Если FireKassa возвращает ссылку на оплату вместе с реквизитами, ее можно показать в заявке в виде кнопки или QR-кода.

В поле «Инструкция по оплате для пользователя» нажмите тег «Ссылка на оплату» — в текст вставится готовый блок:

  • {pay_url} — ссылка на оплату.

  • {pay_qr} — QR-код ссылки; для его отображения включите модуль «QR код генератор».

  • Текст между [else] и [/if_pay_firekassa] выводится, если ссылки нет.

Разметку внутри блока можно менять, например оформить ссылку кнопкой

Недоплата и переплата

  • Недоплата — заявка переходит в статус «Ожидание подтверждения от мерчанта» с фактически полученной суммой. Доплаты обновляют сумму, полная оплата зачисляет заявку.

  • Переплата — обработка зависит от настройки «Сумма платежа больше чем требуется»: оставить прежний статус, отправить заявку на проверку или отметить оплаченной.

  • Ошибка платежа — если FireKassa возвращает статус ERROR, заявка переводится в статус ошибки мерчанта.

Разрешенные IP адреса

Если заполняете поле «Разрешенные IP адреса», укажите все адреса FireKassa, каждый с новой строки:

Выполнение требований Firekassa

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

После этого поле для ввода номера телефона будет отображаться в форме обмена для этого направления.

Продолжение настройки

Далее произведите настройку мерчанта следуя общей инструкции по настройке.

Last updated