Приём платежей через Т-Банк (Тинькофф)

Подробная инструкция по созданию магазина на стороне Т-банк по ссылке

Шаг 1: Создание магазина в Т-Банке

На стороне Т-банк создаем Магазин в разделе «Интернет-эквайринг».

Шаг 2: Создание реакции для запроса email в Sambot

На стороне Sambot создаём реакцию для запроса e-mail у пользователя и сохраняем его в параметр, чтобы потом подставлять этот параметр в чек.

  • Заходим в раздел «Реакции» и добавляем новую реакцию.
  • В пункте 4.1 по кнопке «+текст» добавляем сообщение с просьбой отправить адрес электронной почты боту.
    Создание реакции в Sambot: Добавление текстового сообщения Интерфейс Sambot: Добавление реакции с запросом email
  • Тут же в окне добавления текста спускаемся вниз и в поле «Ожидаемый ответ» выбираем «текст».
  • После выбора ниже появится поле «Проверить текст ответа:». Его можно оставить пустым или выбрать «Email» - в этом случае система автоматически проверит ответ пользователя, и если будет прислан ответ, не являющийся электронной почтой, то бот пришлёт сообщение пользователю об этом.
  • Далее в самом низу нажимаем на строку «Сохранить ответ при завершении реакции».
    Настройка сохранения ответа пользователя в Sambot
  • В открывшемся окне отмечаем «Параметр пользователя». Затем указываем название параметра, в который хотим сохранить почту пользователя и выбираем тип хранения.
    Выбор и настройка параметра пользователя для сохранения email
  • Всё сохраняем (настройки параметра, добавленное сообщение). И сохраняем реакцию.

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

Шаг 3: Настройка приема платежей в Sambot

В Sambot заходим в раздел Приём платежей. Указываем название и добавляем способ приёма платежа, выбираем – Т-банк (Тинькофф).

В полях - Идентификатор терминала и Пароль терминала вводим ТЕСТОВЫЕ данные из магазина в Т-банк

Настройка платежной системы Т-банк в Sambot

Включаем пункт «Чек» и в поле «Электронная почта покупателя» указываем параметр, в который сохранили почту пользователя. Для этого открываем подстановки, нажав на иконку человечка в верхнем правом углу над полем ввода. Находим наш параметр в списке и нажимаем на него – параметр автоматически подставится в поле.

Настройка чека и подстановка email покупателя в Sambot

Для чека обязательным является указание почты, телефон можно не указывать!

Также указываем: Система налогообложения, Ставка НДС, Признак предмета расчета – эти данные вносятся в соответствии с данными магазина.

Следующий пункт «Обработка платежей»:

  • «Вручную» – означает, что каждый выставленный счёт вам нужно будет подтверждать вручную в подразделе «Счета»
  • «Автоматически» – означает, что бот будет получать уведомление о платеже от Т-банка и после его получения автоматически запустит реакцию, указанную в кнопке оплаты.

Обратите внимание на пункт «Без промежуточной страницы оплаты»:

  • Пункт отмечен (включен) – в этом случае бот присылает дополнительное сообщение пользователю с кнопками «Перейти к оплате» и «Проверить оплату». Данное сообщение удаляется только при получении оплаты и если оплата была совершена в течение 48 часов после выставления счёта.
  • Пункт не отмечен (выключен) – в этом случае бот не присылает дополнительное сообщение. При нажатии на кнопку оплаты пользователю будет предложено перейти на промежуточную страницу оплаты Sambot.

Если пользователь не оплатил сразу продукт по этой кнопке, и решил оплатить позднее, а у вас уже изменилась стоимость этого продукта, то пользователь оплатит его по той цене, которая была указана в счёте при его выставлении!
Вы можете настроить удаление сообщения через указаное время, но не более 48 часов, чтобы избежать таких случаев

Если всё настроено верно, сохраните интеграцию.

Шаг 4: Создание реакции с кнопкой оплаты и тестовые платежи

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

  • Создаем реакцию с платёжной кнопкой на любую сумму, не забываем запросить данные email перед этим.
  • В реакции по кнопке «+текст» добавляем сообщение и добавляем к нему кнопку
    Добавление платежной кнопки в Sambot
  • В настройках кнопки выбираем тип «Приём платежа».
    Выбор типа кнопки - Прием платежа
  • Заполняем все поля и указываем действие при успешной оплате, выбрав реакцию, которая будет запущена. Также здесь вы можете добавить метку и параметры, если это необходимо. Они будут добавлены пользователю при успешной оплате.
    Настройка платежной кнопки: заполнение полей и выбор реакции
  • Всё сохраняем.

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

Теперь можно совершить тестовые платежи. Следуйте условиям, которые имеются на стороне Т-банк.

Шаг 5: Проведение тестовых платежей и активация магазина

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

Совершите оплату. При оплате вводим данные карты из ТЕСТОВЫХ данных на стороне Т-банк.

Пройдите все тесты от Т-банк. Обратите внимание, что для каждого теста свой номер карты!

Тестовые данные карты для платежей Т-банк

На последнем тесте необходимо выполнить отмену платежа. Для этого на стороне Т-банк совершаем отмену.

Отмена платежа в интерфейсе Т-банк

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

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