Flitt - это модуль онлайн-оплаты, который открывает встроенную платёжную форму прямо на сайте. Покупатель не уходит на отдельную внешнюю страницу оплаты: форма загружается внутри страницы платежа.
См. также: [Платёжные системы](./, Платежи, Движение средств.
Где находится
Модули интеграций → Платежные системы → Flitt
Чем Flitt отличается от обычной оплаты через редирект
У многих банковских модулей схема простая:
- клиент нажимает оплату;
- его перебрасывает на страницу банка;
- после оплаты он возвращается назад;
У Flitt логика другая:
- создаётся платёж;
- на сайте открывается встроенная форма оплаты;
- система сама перепроверяет статус и переводит клиента на успешный или ошибочный результат;
Что можно настроить
У модуля довольно много параметров. На практике их удобно разделить на несколько блоков.
Подключение к Flitt
- Тестовый режим
- Merchant ID
- Secret Key
- Test Merchant ID
- Test Secret Key
Это основа подключения к боевому или тестовому кабинету.
Основные параметры формы
- Валюта
- Язык checkout
- Время жизни платежа, сек
- Design ID
Это влияет на то, как именно будет выглядеть и жить платёжная форма.
Какие способы показывать внутри Flitt
- Показывать группы методов
- Скрыть группы методов
- Разрешенные wallet-методы
- Активная вкладка
Простыми словами, здесь Вы решаете, что именно увидит покупатель:
- карты;
- популярные методы;
- банки;
- кошельки;
- Apple Pay;
- Google Pay;
Внешний вид
- Тема
- Пресет темы
- Лэйаут
Дополнительное поведение
- Показывать поле email
- Показывать комиссию
- Показывать переключение языка
- Показывать описание заказа
- Показывать сумму на кнопке оплаты
- Передавать позиции заказа в reservation_data
- Перепроверять статус через status/order_id
- Расширенное логирование
Как это выглядит для покупателя
После запуска оплаты клиент остаётся на Вашем сайте и видит встроенную форму Flitt.
В ней могут показываться:
- сумма платежа;
- тестовый режим, если он включён;
- доступные способы оплаты;
- встроенная форма ввода данных;
После оплаты система сама периодически проверяет статус и переводит покупателя на результат.
Когда полезен тестовый режим
Тестовый режим нужен, когда Вы:
- только подключаете Flitt;
- хотите проверить форму без реальных денег;
- меняете окружение и не готовы сразу работать в бою;
Что важно помнить про повторные попытки
У Flitt в коде предусмотрена логика повторной попытки, если старая попытка оплаты уже зависла или была начата в другом окружении.
Простыми словами:
- если раньше платёж начали в тестовом режиме, а потом переключили модуль в боевой;
- или если по старой попытке уже нельзя получить нормальный токен;
система старается аккуратно перезапустить попытку, а не держаться за старую неверную сессию.
Когда включать расширенное логирование
Флаг «Расширенное логирование» полезен только для диагностики:
- когда модуль не получает токен;
- когда платёж не подтверждается;
- когда нужно понять, что именно вернул шлюз;
В обычной спокойной работе его лучше держать выключенным.
Пример базовой настройки
Если Вы только начинаете, обычно хватает такого варианта:
- Тестовый режим - включён
- Язык checkout -
ru - Валюта - нужная валюта магазина
- Показывать группы методов - карты и кошельки
- Активная вкладка - карты
- Перепроверять статус через status/order_id - включено
Что проверить после настройки
- Создаётся ли сама форма оплаты.
- Остаётся ли покупатель на сайте, а не уходит на внешнюю страницу.
- Меняется ли статус платежа после успешной оплаты.
- Корректно ли работает тестовый режим.
- Не включено ли расширенное логирование без необходимости.