FireKassa Card/Link
Настройки в личном кабинете мерчанта
Пройдите регистрацию на сайте 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