Интернет-эквайринг Т-Банк

Модуль «Эквайринг Т-Банк» подключает приём оплаты картой и СБП в FightCRM: личный кабинет клиента (/my), быстрая оплата (/pay), оплата на стойке — там, где у способа оплаты включён интернет-эквайринг.

Ключ и пароль терминала настраиваются один раз в «Модули». В способах оплаты вы только выбираете готовое подключение по названию.

Вам нужен договор интернет-эквайринга и созданный интернет-магазин в кабинете Т-Банка. Без этого раздела «Терминалы» будет пустым.

Официальная справка банка: [как войти в кабинет](${TBANK_HELP_CABINET}), [где найти терминал и пароль](${TBANK_HELP_TERMINAL}).

• Откройте tbank.ru → Войти (правый верхний угол) → вход по телефону или логину.
• Выберите вкладку «Интернет-эквайринг» (кабинет Т-Бизнес для приёма платежей на сайте).
• Слева откройте «Магазины» → «Интернет-магазины» → выберите ваш магазин (если магазина нет — создайте по инструкции банка или через чат поддержки Т-Бизнеса).
• Внутри магазина откройте «Терминалы».
• Для первой настройки часто используют «Тестовый» терминал; для реальных денег — «Рабочий» (банк может требовать несколько тестовых платежей перед активацией рабочего).
• Нажмите «Настроить» у нужного терминала — на экране будут строки «Терминал» и «Пароль». Это то, что копируете в FightCRM.

Откройте «Модули» → «Эквайринг Т-Банк» (/club/modules/acquiring-tbank) → «Добавить подключение». Соответствие полей:

• Название подключения (FightCRM) — придумайте сами, для людей: «Основной Т-Банк», «Абонементы».
• Terminal Key (FightCRM) ← строка «Терминал» в кабинете Т-Банка (Магазины → Терминалы → Настроить).
• Пароль терминала (FightCRM) ← строка «Пароль» там же. Копируйте сразу; в банке пароль потом может не показываться — только сброс.
• API URL (FightCRM) — для боевых платежей оставьте `https://securepay.tinkoff.ru/v2` (подставляется по умолчанию). Для тестового терминала банк может дать другой адрес — укажите тот, что в инструкции к тестовому терминалу.
• Юрлицо продавца в чеке — если в клубе несколько организаций, выберите нужную; иначе оставьте «По умолчанию клуба».
• Notification URL, Success URL, Fail URL — для старта можно оставить пустыми; FightCRM подставит адреса при оплате. Заполняйте только если банк или интегратор дал отдельные URL.
• Подключение активно — галочка должна быть включена.

Чтобы банк сразу сообщал FightCRM об успешной оплате, в настройках терминала в кабинете Т-Банка укажите адрес уведомлений (Notification URL):

`https://ваш-клуб.fightcrm.ru/api/payments/webhook?provider=tbank` — подставьте ваш поддомен клуба вместо `ваш-клуб`.

Тот же адрес можно вписать в поле Notification URL в подключении FightCRM. Если поле пустое — при создании платежа система всё равно передаёт URL в банк автоматически.

Страницы успеха и ошибки оплаты для клиента настраиваются в способе оплаты (переопределение) или задаются по сценарию оплаты в FightCRM.

• Тестовый — для проверки без реальных списаний. Данные берёте из раздела «Тестовый» → «Настроить» в кабинете банка.
• Рабочий — для приёма денег от клиентов. Данные из «Рабочий» → «Настроить».
• Не смешивайте: пароль тестового терминала не подойдёт к боевому API URL и наоборот.
• После смены пароля в банке обновите Пароль терминала в FightCRM и снова нажмите «Проверить подключение».

• Модуль «Эквайринг Т-Банк» в «Тариф» → «Модули».
• Право «Редактирование настроек» — для раздела «Модули».
• Право «Управление организациями и счетами клуба» — для привязки к способам оплаты в «Баланс клуба».
• Готовые Terminal Key и пароль из кабинета Т-Банка (см. разделы выше).

Откройте «Тариф» (/club/tariff) → вкладка «Модули». В списке должен быть подключён модуль «Эквайринг Т-Банк» (или «Онлайн-эквайринг Т-Банк» — формулировка в тарифе может отличаться).

Если модуля нет — оформите его в тарифе или обратитесь в поддержку FightCRM. Без модуля страница настроек эквайринга будет недоступна или покажет, что модуль не в подписке.

Перейдите «Модули» → «Эквайринг Т-Банк» (/club/modules/acquiring-tbank).

Включите переключатель «Модуль включён для клуба». Это operational-тумблер: при выключении все подключения Т-Банка перестают работать в онлайн-оплатах, но сами подключения не удаляются.

«Модули» → «Эквайринг Т-Банк» → «Добавить подключение». Вставьте данные из кабинета банка (см. таблицу соответствия выше) → «Сохранить».

Нажмите «Проверить подключение». Успех — FightCRM связался с API Т-Банка.

Если ошибка: (1) перепроверьте Терминал и Пароль в банке; (2) убедитесь, что используете тестовый или рабочий терминал согласованно с API URL; (3) терминал активен в кабинете банка; (4) после смены пароля в банке введите новый пароль в FightCRM.

Онлайн-оплата срабатывает только у способа оплаты с включённым интернет-эквайрингом. Привязку можно сделать двумя способами:

• На странице подключения — в блоке «Способы оплаты» включите переключатель у нужных маршрутов (после сохранения ключа и пароля).
• В финансах — «Баланс клуба» → «Счета» (/club/finances/club-balance/accounts): откройте способ оплаты, включите интернет-эквайринг, в списке выберите подключение «… · Т-Банк».
• Ключ и пароль терминала не вводят в способе оплаты — только выбор подключения.

Если у клуба несколько терминалов или юрлиц, создайте отдельное подключение на каждый терминал с понятным названием. В разных способах оплаты выбирайте нужное подключение.

Удалить подключение нельзя, пока оно привязано к способу оплаты — сначала отключите его в блоке «Способы оплаты» или в настройках маршрута.

• ☐ Договор и магазин в Т-Банке → Магазины → Терминалы → Настроить → скопировать Терминал и Пароль.
• ☐ Модуль Эквайринг Т-Банк в тарифе FightCRM.
• ☐ Модули → включить модуль → Добавить подключение → вставить ключ и пароль → Сохранить → Проверить.
• ☐ (По желанию) Notification URL в банке: `https://поддомен.fightcrm.ru/api/payments/webhook?provider=tbank`.
• ☐ Привязать к способам оплаты (на странице подключения или в Баланс клуба → Счета).
• ☐ Тестовая оплата в ЛК или на стойке.

• Проверка не проходит — чаще всего неверный Пароль или перепутаны тестовый и рабочий терминал. Откройте в банке: Магазины → Терминалы → Настроить и скопируйте заново.
• Клиент не видит оплату картой — модуль в тарифе и включён; подключение активно и проверено; у способа оплаты включён интернет-эквайринг и выбрано это подключение; способ виден клиенту.
• Оплата прошла, статус в CRM не обновился — проверьте Notification URL в терминале банка (см. раздел про уведомления).
• Быстрая оплата /pay — настраивается в «Правила оплат»; эквайринг берётся из тех же подключений.