Как подключить Т-Банк, принимать оплату и работать с залогом

Т-Банк позволяет привязать карту клиента и списывать с неё деньги за аренду. Клиент вводит данные карты один раз, на странице банка, — дальше сотрудник может принять оплату с этой карты, а автопродление может пополнять с неё баланс клиента.

Кому доступно

Т-Банк доступен компаниям из России, которые работают в рублях. У других компаний панели настроек нет, а сервер отказывает в настройке, привязке карты и списании.

Важно

Это ограничение проверяет сервер, а не только интерфейс. Если страна или валюта компании не подходят, подключить Т-Банк не получится ни в каком месте системы.

Как подключить терминал

Данные терминала меняет только менеджер и выше.

1. Откройте профиль компании, вкладка «Интеграции».
2. Раскройте панель «Т-Банк (Тинькофф)».
3. Включите оплату через Т-Банк и впишите терминал и пароль из кабинета банка.
4. Выберите систему налогообложения и ставку НДС — они попадут в чеки.
5. По желанию укажите ссылки на тарифы, пользовательское соглашение и политику конфиденциальности (см. ниже).
6. Сохраните настройки.

Проверка данных терминала

При сохранении новых данных система проверяет их запросом к Т-Банку. Если терминал или пароль неверны, настройки не сохраняются и вы увидите отказ.

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

Пароль виден только как «задан»

Пароль терминала хранится в зашифрованном виде и никогда не возвращается в интерфейс: ни вам, ни другим сотрудникам. После сохранения поле остаётся пустым, а под ним появляется подсказка «Пароль задан».

• Чтобы не менять пароль, оставьте поле пустым и сохраните.
• Чтобы заменить пароль, впишите новый — он пройдёт ту же проверку.

Как привязать карту

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

Привязка сотрудником

1. Откройте карточку клиента и найдите блок «Привязанная карта».
2. Нажмите значок добавления карты.
3. В диалоге отметьте «Клиент дал согласие на списания с привязанной карты».
4. Подтвердите — откроется страница Т-Банка, где клиент вводит данные карты.

Без отметки согласия карта не привяжется. Согласие записывается на клиента вместе с датой и источником: «сотрудник».

Привязка самим клиентом

Клиент может привязать карту на странице бронирования (см. личный кабинет). Ему показываются:

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

Важно

Заполните ссылки в панели «Т-Банк (Тинькофф)»: клиент соглашается с условиями, которые видит. Без ссылок согласие даётся «вслепую».

Доступ к привязке клиент получает так же, как ко всей странице, — по номеру бронирования и фамилии. Если фамилия не совпадает, система отвечает, что привязать карту не удалось, и просит проверить фамилию, указанную в бронировании. Согласие записывается с источником «страница клиента».

Без согласия привязки нет — ни у сотрудника, ни у клиента. Это условие и для автоматических списаний с карты.

Как отвязать карту

Карту может отвязать сотрудник в карточке клиента или сам клиент на странице своего бронирования. Клиент видит действие «Отвязать карту».

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

Система просит банк удалить карту. Если банк отвечает, что такой карты нет, это считается успешной отвязкой. Если банк недоступен или отклонил операцию, карта остаётся привязанной: повторите позже. После успешной отвязки прекращаются автоматические списания с этой карты.

Как списать оплату с привязанной карты

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

Важно

Переключатель выключен по умолчанию. Включайте его осознанно: карта клиента будет списана на сумму оплаты.

Что важно знать:

• списание идёт в рублях; если среди строк оплаты есть другая валюта, система откажет до записи платежа;
• списание разрешено, только если у филиала бронирования тот же терминал, к которому привязана карта. Если вы перенесли транспортное средство в филиал с другим терминалом, оплата с карты откажет («списание с карты недоступно»), а у периодических бронирований источник пополнения автоматически переключится на «С баланса клиента»;
• повторная отправка безопасна: если ответ потерялся или вы дважды нажали кнопку, карта не будет списана дважды;
• приложение с давно устаревшей версией не сможет списывать с карты — система попросит обновить приложение. Платёж при этом не проводится.

Как читать статусы платежей

В карточке бронирования у каждого платежа Т-Банка есть столбец «Исход»:

Исход	Что значит
Прошёл	Деньги списаны и проведены
Частичный возврат	Банк вернул часть суммы
Возврат	Банк вернул платёж целиком
Отказ	Банк отклонил платёж
Уточняется	Ответа банка ещё нет, система ждёт и проверяет
Исход неизвестен	Банк не подтверждает результат больше суток

Возвраты вы делаете в кабинете Т-Банка, а не в RentProg: система только обрабатывает сообщение банка и сама разворачивает проведённые суммы. Возврат пополнения баланса может увести баланс клиента в минус.

Подсказка

Отказ по ручному списанию отменяет его непроведённые строки, а ошибка видна в карточке бронирования. Если после отказа банк всё-таки сообщит об успехе, платёж будет проведён по окончательному ответу банка.

Строки оплаты, которыми распоряжается банк

Строки оплаты, отправленные в Т-Банк, меняет только ответ банка. Так учёт не расходится с тем, что банк реально списал или вернул.

• Пока банк не ответил, такую строку нельзя изменить, провести вручную или отменить. Дождитесь ответа или зафиксируйте исход вручную (см. ниже).
• Сумму, вид оплаты и кассу такой строки нельзя изменить и после ответа банка.
• После успешного списания строку можно отменить. Если затем банк пришлёт возврат, система не развернёт эту сумму второй раз.
• После возврата отменить строку нельзя: банк уже развернул её сам.
• Отменённую строку и связанную с ней отменяющую запись больше нельзя изменить, отменить или провести.

Залог холдом

Залог по карте ставится холдом: банк временно блокирует сумму на карте клиента, но не списывает её. Холд и разблокировка бесплатны; комиссия банка берётся только с суммы, которую прокат действительно оставил себе.

Как обработать залог при приёмке

В диалоге приёмки укажите удержания, например за мойку, топливо или повреждения. Для каждого удержания заполните «Основание удержания», «Причина» и сумму.

Оставшаяся часть залога возвращается клиенту сразу. Если нужно дождаться штрафов или проверить скрытые повреждения, включите «Отложить» и укажите дату в поле «Удерживать до». По умолчанию система подставляет «срок частичного возврата залога» из настроек компании; при приёмке дату можно изменить.

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

Что можно сделать в карточке бронирования

В блоке «Залог» видны сумма в холде, уже удержанная сумма, отложенная часть и срок. Здесь доступны действия:

• «Удержать из залога» — добавить удержание с основанием, причиной и суммой;
• «Продлить срок» — изменить дату возврата отложенной части;
• «Закрыть залог» — вернуть свободный остаток и завершить работу с залогом;
• «Отменить удержание» — убрать удержание, пока банк ещё не списал эту сумму;
• «История банковских операций» — проверить разблокировки, списания, новый холд и ответы банка.

Если банк ещё обрабатывает предыдущую операцию, система покажет: «Банк ещё обрабатывает залог, повторите через минуту». Дождитесь обработки и повторите действие.

Как удержать штраф

В карточке штрафа выберите «Удержать из залога».

• Если остатка залога хватает, штраф оплачивается из него.
• Если штраф больше остатка, доступная часть берётся из залога, а разница списывается с привязанной карты.
• Если списание разницы не прошло, штраф остаётся частично неоплаченным. Примите остаток обычным действием «Оплачен клиентом».

Если залог не обеспечен

При продлении блокировки банк может отказать: например, на карте недостаточно денег, карта отвязана или недоступна для нового холда. В карточке бронирования появится «Залог не обеспечен» с причиной.

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

Уведомления по залогу

• Канал для сотрудников филиала — уведомления в колокольчике, канал компании — почта для бронирований.
• Клиент получает сообщения по шаблонам компании — на доступную почту и в подключённые мессенджеры.
• О техническом продлении блокировки клиенту не пишем.

Уведомления приходят, когда залог поставлен или обработан при приёмке, удержан штраф, залог закрыт, карта с активным залогом отвязана либо залог перестал быть обеспечен.

Если исход платежа неизвестен

Бывает, что ответ банка не пришёл: сбой сети, ошибка на стороне банка, таймаут. Это не отказ. Система сама сверяется с банком примерно каждые 15 минут и не повторяет списание, чтобы не списать дважды.

Если больше суток ответа нет, платёж получает исход «Исход неизвестен» и отметку, с какого времени. Тогда менеджер или выше может зафиксировать результат вручную:

1. Проверьте платёж в личном кабинете Т-Банка.
2. В карточке бронирования нажмите «Зафиксировать исход» у этого платежа.
3. Выберите «Платёж прошёл» или «Платёж не прошёл».

Решение записывается в журнал операций — кто и когда его принял. Если банк потом всё же пришлёт ответ, система обработает его по обычным правилам.

Чек

Т-Банк принимает чек только на русском языке, поэтому позиции чека — названия статей строк оплаты так, как они заведены в компании. Пополнение баланса с карты в чеке — предмет расчёта «платёж», способ расчёта — полный расчёт.

Для отправки чека у клиента должен быть email или телефон. Если не заполнено ни одно из полей, система не начнёт операцию и покажет: «У клиента нет email и телефона — Т-Банку некуда отправить чек. Добавьте email или телефон в карточке клиента».