Интернет-эквайринг Т-Банк приём платежей

• Электронная почта: rover.webdev@gmail.com

• Форма обращения в техническую поддержку: https://rover-it.me/support/new/

• Режим работы: будние дни с 10:00 до 18:00 по московскому времени, выходные и праздничные дни — нерабочие.

• Время реакции на обращение: до одного рабочего дня.

• Лицензионное соглашение: https://rover-it.me/about/tbank24-license/

• Политика безопасности и обработки данных: https://rover-it.me/about/tbank24-security/

• Вопросы по условиям эквайринга, комиссии и зачислению средств решает Т-Банк — приложение на них не влияет.

В пункте меню «Т-Банк» откройте страницу «Поддержка». Блок «Если нужна поддержка» нажмите — он выделится целиком, скопируйте его, а кнопкой «Создать обращение» рядом откройте форму и вставьте туда. В блоке адрес портала, его код, код решения, дата установки, часовой пояс и номера платёжных систем — по ним в поддержке найдут вашу историю, не переспрашивая. Там же написано, когда мы отвечаем.

Опишите рядом, что именно произошло и примерно во сколько, а если дело в конкретной оплате — её номер из вкладки «Оплата Т-Банк» в сделке. Паролей и ключей в блоке нет, пересылать его безопасно.

1. Откройте карточку приложения в Битрикс24 Маркетплейсе и нажмите «Установить».
   
2. Дождитесь окончания установки — приложение само зарегистрирует обработчик платёжной системы «Т-Банк: интернет-эквайринг» и подпишется на удаление приложения. Отдельных действий не требуется.
   
3. После установки в главном меню появится пункт «Т-Банк» с реестром платежей, а в карточках сделок и счетов — вкладка «Оплата Т-Банк». Вернитесь в реестр, если что-то пойдёт не так: там видно, по каким платежам состояние ещё не доехало до Битрикс24.
   

1. Откройте «Центр продаж» → «Платёжные системы» и добавьте платёжную систему на обработчике «Т-Банк: интернет-эквайринг».
   
2. Поправьте название. Битрикс24 подставляет в него служебный код обработчика — «Т-Банк: интернет-эквайринг (ROVER_TBANK)». Приписку в скобках сотрите: это название покупатель видит при оформлении заказа.
   
3. Заполните поля — их состав ниже.
   
4. Сохраните. Реквизиты хранятся в вашем Битрикс24; приложение получает их в момент оплаты.
   

Поля карточки платёжной системы

— Терминал — ключ терминала (TerminalKey) из личного кабинета Т-Банка.

— Пароль терминала — пароль того же терминала.

— Система налогообложения — обязательно, выбирается из списка: Общая, УСН доход, УСН доход минус расход, ЕНВД, ЕСН, Патент. Без неё чек по 54-ФЗ не формируется, а боевой терминал без чека оплату не примет.

— Ставка НДС по умолчанию — обязательно, из списка: Без НДС, 0 %, 5 %, 7 %, 10 %, 20 %, 22 % и расчётные формы. Применяется к позициям заказа, у которых ставка не указана: ноль в заказе означает «не задана», а не «ноль процентов», и угадывать за вас приложение не вправе.

— Автоподтверждение холда через, часов — только для двухстадийной схемы. Оставьте пустым, если подтверждаете списание вручную.

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

— Страница после удачной оплаты и Страница после неудачной оплаты — куда банк вернёт покупателя. Пусто — покупатель увидит стандартную страницу: страницу заказа Битрикс24, если оплата начата из магазина или кнопкой «Принять оплату», и страницу приложения, если ссылку сделал робот. Заполните полным адресом с https://, если у вас есть своя страница «спасибо за оплату».

Если начать платёж, не заполнив терминал и пароль, приложение вернёт в Битрикс24 понятное сообщение с указанием, куда идти, — оплата при этом не создастся.

1. Откройте сделку и нажмите «Принять оплату», укажите товар и сумму.
   
2. В окне оформления выберите созданную платёжную систему.
   
3. Оплатите тестовой картой из документации Т-Банка, если терминал в тестовом режиме, или небольшой реальной суммой на боевом терминале.
   
4. Через несколько секунд оплата в Битрикс24 станет оплаченной. Если этого не произошло, загляните в пункт меню «Т-Банк»: там видно, сколько платежей ещё не доехало до Битрикс24.
   

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

Если робот не смог сделать ссылку, причина появится в ленте сделки — записью «Т-Банк: ссылка на оплату не создана» с жёлтой пометкой «Отказ». Она же доступна свойством «Причина отказа», которое можно вывести в своё оповещение, и видна в разделе «Т-Банк» (последние неудачи за сутки).

Настройка «Не создавать ссылку, если уже оплачено» отвечает «Да» или «Нет». «Да» (по умолчанию) — если сделка уже оплачена или по оплате висит незакрытый холд, робот вернёт текст вместо ссылки: так покупателя не спишут второй раз. «Нет» — робот создаст ещё одну оплату по сделке и выдаст ссылку на неё.

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

1. Откройте CRM → Сделки, вид «Канбан». Нажмите «Роботы» над колонками (в некоторых версиях — «Настроить роботов» в меню стадии).

2. Выберите стадию, на которой нужна ссылка, и нажмите «Добавить робота».

3. Робот лежит в группе «Приложения» и называется «Ссылка на оплату Т-Банк (ТБанк)». Проще найти его поиском — по «Т-Банк» или по «ТБанк», находится и так и так.

4. Настроек две.

   «Не создавать ссылку, если уже оплачено» — включена по умолчанию. Пока она стоит, робот не выдаст вторую ссылку по элементу, оплаты которого уже покрывают его сумму: вернёт текст с суммами вместо ссылки. Это защита от второго списания, когда сделка повторно входит на стадию. Снимите галочку, если по сделке нужна доплата.

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

5. Добавьте следующим шагом отправку. Сам робот ничего не отправляет. После него поставьте обычного робота Битрикс24 — «Отправить письмо», «Отправить SMS» или «Сообщение в чат». В тексте, там где нужна ссылка, выберите из списка полей результат предыдущего робота — «Ссылка на оплату». Рядом доступны «Номер оплаты» и «Причина отказа».

6. Сохраните и проверьте: переведите тестовую сделку с товаром на эту стадию. Через несколько секунд в сделке появится оплата на платёжной системе Т-Банка, а в письме или SMS уйдёт ссылка на страницу оплаты банка.

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

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

Если ссылка не пришла, причину видно в двух местах. Первое — свойство «Причина отказа»: его стоит вывести в своё оповещение рядом со ссылкой, тогда она придёт вместе с письмом. Второе — пункт меню «Т-Банк»: там наверху показаны последние неудачи робота с номером сделки и причиной. Робот отвечает всегда, и причина написана словами — например «нет платёжной системы Т-Банка» или «в сделке нет товаров».

Страница оплаты расположена на стороне Т-Банка и использует российский сертификат безопасности НУЦ Минцифры. Яндекс Браузер и Атом поддерживают его по умолчанию; в Chrome, Firefox, Safari, Edge и Opera корневой сертификат нужно установить вручную — иначе браузер покупателя покажет предупреждение о незащищённом соединении.

Инструкция по установке сертификатов для всех платформ: https://www.gosuslugi.ru/crt

Приложения и Битрикс24 это не касается: оговорка нужна покупателю, который переходит на страницу банка.

При удалении приложения Битрикс24 сам снимает зарегистрированную платёжную систему и подписку на события. Приложение получает уведомление об удалении и перестаёт обращаться к порталу. История платежей сохраняется на нашей стороне и снова станет доступной, если приложение установить заново.