Т-Банк (Tinkoff): инструкции по настройке

Чтобы настроить для проекта интеграцию с Т-Банком, откройте в браузере две вкладки — настройки проекта в панели управления Taptop и личный кабинет на сайте Т-Банка. Далее необходимо настроить их параметры, выполнив следующие шаги:

1. Создайте магазин на сайте Т-Банка

На сайте Т-Банка в личном кабинете перейдите в раздел «Магазины», нажмите кнопку «Создать магазин» и выберите «Интернет-магазин».

Заполните анкету магазина:

  • Название — любое на латинице. Оно будет указано в чеках, квитанциях и в вашем личном кабинете.
  • URL-адрес сайта.
  • Сфера деятельности — например, продажа детских товаров или рассылка о дизайне.
  • Регион работы — выберите Россию, даже если доставка только по одному городу, другие страны — если доставляете в них.
  • Контакты — электронная почта и телефон.
  • Фактический адрес — если его нет, укажите юридический адрес ООО или ИП.

2. Настройте тестовый терминал интернет-эквайринга на сайте Т-Банка

Тестовый терминал нужен, чтобы провести пробный платеж и убедиться, что форма оплаты на сайте работает правильно.

Перейдите в раздел «Терминалы».

Выберите тестовый терминал и нажмите кнопку «Настроить».

Выберите в настройках «Подключение» — «Универсальное» и «Уведомления» — «По протоколу HTTP». Нажмите кнопку «Сохранить».

3. Добавьте платежную систему в настройках проекта в Taptop

Перейдите на сайт Taptop и откройте настройки проекта, нажав на три точки в карточке проекта и выбрав пункт меню «Настройки».

Перейдите в раздел «Интеграции» — «Платежные системы» и нажмите кнопку «Добавить платежную систему».

Выберите из списка Tinkoff.

Выберите валюту оплаты. Для данного банка доступна только оплата в рублях.

Ниже откроются дополнительные поля, но они понадобятся вам позже.

4. Настройте параметры авторизации

На сайте Т-Банка — скопируйте идентификатор Тестового терминала.

На сайте Taptop в настройках платежной системы — вставьте идентификатор в поле «Идентификатор терминала».

На сайте Т-Банка — скопируйте пароль Тестового терминала.

На сайте Taptop в настройках платежной системы — вставьте пароль в поле «Пароль».

Далее заполните следующие параметры:

  • E-mail — почтовый адрес, на который будут приходить уведомления об оплатах. Например, можно указать email менеджера, который будет обрабатывать заказы.
  • Язык — почти всегда вам нужен русский язык. Исключение, когда у вас есть англоговорящие клиенты, то выберите английский.

5. Настройте параметры уведомлений

Без этой настройки платежи в Taptop работать не будут!

Чтобы настроить уведомления:

  1. На сайте Taptop в настройках платежной системы скопируйте ссылку «Notify URL».

  1. На сайте Т-Банка перейдите в настройки Тестового терминала, нажав кнопку «Настроить».

В разделе «Уведомления» — «По протоколу HTTP» вставьте скопированную ссылку.

  1. Нажмите кнопку «Сохранить».

6. Завершите подключение платежной системы в тестовом режиме

На сайте Taptop в настройках платежной системы нажмите кнопку «Подключить» внизу страницы.

* На этом этапе не требуется заполнять остальные поля формы.

7. Проверьте, проходит ли оплата на тестовом терминале

Проведите три тестовые оплаты  — Успешный платеж, Неуспешный платеж, Отмененный платеж.

Шаг 1. Чтобы начать процесс, в личном кабинете Т-Банка нажмите кнопку «Тестировать» в Тестовом терминале.

После этого откроется раздел «Тестирование платежей», содержащий данные карт для прохождения трех тестов.

Шаг 2. На вашем сайте создайте форму оплаты. Подробная инструкция по созданию формы оплаты.

Шаг 3. Вам необходимо провести оплату через форму три раза разными тестовыми картами, чтобы проверить три разных статуса оплаты:

1. Оплата подтверждена. Оплатите заказ с помощью тестовой карты «Тест №1».

2. Оплата отменена. Оплатите заказ с помощью тестовой карты «Тест №2».

3. Оплата возвращена полностью. Оплатите заказ с помощью тестовой карты «Тест №3». После этого перейдите в личный кабинет Т-Банка в раздел «Операции» и в последней по времени транзакции сделайте возврат оплаты. Для это нужно открыть транзакцию и нажать кнопку «Вернуть». Далее будет отображена сумма оплаты, и нужно будет подтвердить ее возврат, повторно нажав кнопку «Вернуть».

Если возникла ошибка или операция не работает так, как нужно, то повторите действия еще раз. Если ошибка повторяется, свяжитесь со службой поддержки банка.

Почему после совершения оплаты нет уведомления об ее подтверждении?

На данный момент интеграция платежей в Taptop работает так, что после оплаты вас сразу перебрасывает на ваш сайт. Посмотреть подтверждение оплаты можно в кабине Т-Банка в разделе «Операции» или в настройках проекта в Taptop в разделе «Заявки».

Если у вас возникла ошибка при совершении платежа, перезагрузите страницу сайта.

Шаг 4. Когда все тесты будут пройдены, на сайте Т-Банка в разделе «Тестирование платежей» нажмите кнопку «Проверить».

Шаг 5. Перейдите в раздел «Терминалы». Если в Рабочем терминале отображается статус «Включен», то переходите к его настройке.

Если вы не видите данного статуса — напишите в службу поддержки банка.

8. Настройте рабочий терминал на сайте Т-Банка

Нажмите кнопку «Настроить» в Рабочем терминале.

Далее необходимо:

  • перенести идентификатор терминала и пароль в настройки вашего сайта на Taptop.
  • перенести Notify URL в Рабочий терминал Т-Банка.

Если забыли, как это сделать, то можно вернуться к пунктам 4 и 5, но данные нужно взять из Рабочего терминала.

9. Настройте дополнительные параметры платежей на сайте Taptop

Дополнительные настройки платежной системы используются для транзакций, которые передаются в банк. Это может понадобиться для ФНС.

На сайте Taptop настройте следующие параметры:

  • Налог, название и процент — Необязательные поля, используются редко. Поля для указания налогов. По умолчания опция выключена. Чтобы добавить налог, переключите свитчер и введите его название и значение в процентах. Если вы добавите налог, то все транзакции, которые будут созданы с данной системой оплаты, будут идти с надбавкой на величину налога.

  • Признак предмета платежа. Выберите, что именно вы продаете.

  • Признак способа платежа — полный расчет или полная предоплата. Этот параметр используется для системы фискализации.

На момент написания этой документации (22 августа 2024 года) корректно работает только полный расчет.

Если вам нужна полная предоплата, то напишите в службу поддержки Taptop — узнайте о возможности подключения.

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

Полная предоплата подразумевает 2 чека: первый — когда вы получили деньги, второй — когда вы передали товар заказчику.

  • Система налогообложения — выберите используемую систему расчета налогов.

10. Настройте выдачу чеков и выберите систему налогообложения на сайте Taptop

Для отправки клиентам чеков об оплате включите фискализацию.

На сайте Т-Банка настройте онлайн-кассу.

Узнать подробную информацию об онлайн-кассе и оставить заявку на ее подключение вы можете на сайте Т-Банка.

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

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

Для настройки фискализации необходимо также выбрать Версию ФФД.

Версия ФФД — это один из форматов фискальных документов. Он определяет, какие документы должна формировать касса и как они выглядят.

В России действуют три формата фискальных данных:

  1. ФФД 1.05. Старый формат, который считался переходным от 1.0 к 1.1.
  2. ФФД 1.1. Самый подробный и удобный формат для всех, кто не работает с маркированным товаром.
  3. ФФД 1.2. Новый формат, введённый 6 августа 2021 года. Предназначен для работы с маркированным товаром.

Формат фискальных документов устанавливает ФНС. Любая касса обязательно формирует чеки в каком-то из установленных форматов. ФФД прописан в программном обеспечении кассы и обязательно указывается при регистрации кассы в налоговой. Вы можете уточнить используемый вашей кассой ФФД в банке.

Система налогообложения по умолчанию (пустое поле)

Эта опция требуется редко. Для ее настройки и выяснения подробностей, напишите в службу поддержки Taptop через виджет справа внизу страницы.

11. Дополнительно: вы можете подключить оплату по QR-коду

Для подключения оплаты по QR-коду вам нужно включить систему быстрых платежей на стороне T-Банка. Для этого перейдите в раздел «Способы оплаты» и активируйте чекбокс рядом с пунктом «Система быстрых платежей».

Чтобы подключить систему быстрых платежей в Taptop, в настройках платежной системы выберите значение «Да» в поле «Использование системы быстрых платежей (QR-код)».

12. Завершите подключение платежной системы в рабочем режиме

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

Готово! Интеграция с платежной системой Т-Банка настроена.

13. Важно помнить!

Для каждого товара необходимо создать отдельную форму оплаты. Инструкция.

Просмотреть информацию о заказах и статусах их оплаты можно в настройках проекта в разделе «Заявки». Подробнее — Просмотр заказов.