Интеграция с Tinkoff

Всем привет.

Сегодня будет проведена интеграция с Интернет-эквайрингом банка Tinkoff. Ранее интеграцию на запросах делал Андрей Левицкий, а теперь у нас есть прямая интеграция с этой платежной системой.

Для начала переходим на сайт oplata.tinkoff.ru нажимаем «Войти».

Важно! У вас должен быть подключен интернет-эквайринг. Как его подключить написано на сайте. По техническим вопросам пишите в техподдержку Тинькофф: [email protected]
Важная информация: Знание номера терминала и пароля даст возможность создавать платежи, отменять их, запрашивать статус ранее проведенных платежей. Доступа к счёту, личному кабинету, и каким-либо другим параметрам оно не даёт, поэтому можете доверять эту информацию Автоматизаторам.

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

Выписываем идентификатор терминала и пароль. Идем в Автопилот.

Настройки в Автопилоте

Когда секретный ключ успешно найден, можно приступать к настройке в Автопилоте (рекомендую делать в отдельной вкладке, а вкладку с Tinkoff при этом не закрывать).

В АП в списке подключенных сообществ найдите нужное и откройте его «Настройки» нажав на соответствующую белую кнопку в карточке сообщества.

В настройках на первой вкладке Интеграции найдите раздел Tinkoff Интернет-эквайринг и там:

• вставьте ID терминала (1) в первое поле;
• пароль от терминала вставьте во второе поле;
• ссылку на вебхук (6) из соответствующего поля нужно скопировать и вставить в Tinkoff в соответствующее поле (см. скриншоты ниже);
• для выбора Системы налогообложения (3) кликайте на знак вопроса копируйте нужное вам значение в нужное поле (не забудьте сохранить);
• аналогично для ставки налога (4) и типа продукта (5). Эта информация необходима для передачи чеков, поэтому ее настраивайте самостоятельно в соответствии с вашим налоговым режимом.

Для передачи чеков в кабинете Tinkoff настраиваете на вкладке «Онлайн касса», всю информацию узнавайте у менеджеров Tinkoff.

Важно! Обязательно при настройке не забудьте протестировать оплату тестовыми картами, проведите настройку терминала и вставьте вебхук в настройки терминала.
Если у вас несколько сообществ, то достаточно прописать в настройках сообществ имя терминала, пароль, а в Tinkoff вебхук от одного сообщества, а АП далее сам разрулит, иначе будут задвоения. Будьте внимательны.

Дальше создайте событие с типом «Оплатил / сделал перевод» (добавьте его в любую команду) и проведите тестовый платеж, чтобы проверить работу интеграции. Рекомендую для начала делать универсальную настройку, как в этом разделе статьи.

Прохождение тестов

Тест №1 может вызвать у вас затруднение: надо в ответе передать Тинькоф OK.

Как это сделать? Легко. В одной команде делаете событие: «Входящий запрос» с доп. параметрами:

&to=OK

Далее копируем ссылку вида

https://yourlink?avtp=1&to=OK

и вставляем в отдельной команде в действие: «Создать счет для Tinkoff» доп. параметром NotificationURL c этой ссылкой

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

Остальные тесты можете проверять с помощью события: «Оплатил / сделал перевод» и действия: «Создан счет для Tinkoff»

Создание заказа

• Для создания нового заказа воспользуйтесь действием
  «Создать счет для Tinkoff»
• Рекомендуется реагировать этим действием на заполнение формы (так как она умеет сразу собирать телефоны), но можно и на обычное ключевое слово в сообщения сообщества, заказ из раздела Товары или любое другое событие.
• Все поля действия рекомендуется оставлять по умолчанию. Это универсальные значения, которые подходят для заказов из раздела товары (таких, какие показаны в этом примере). Но вы можете вручную изменять переменные %vk_product_title% и %vk_product_price% на удобные вам название товара и цену соответственно.
• Дальше вставляйте переменную %payment_link% в сообщение, которое обязательно должно быть следующим действием после запроса.

Детальнее про возможности действия смотрите по этой ссылке.

Уведомление про успешную оплату

Важно! Если у вас несколько сообществ, то достаточно прописать в настройках сообществ имя аккаунта, ключи, а в Tinkoff oвебхук от одного сообщества, а АП далее сам разрулит, иначе будут задвоения. Будьте внимательны.

Интеграция с Tinkoff позволяет принимать и реагировать на оплаты не только ВКонтакте, но и в Telegram с помощью события: «Оплатил / сделал перевод» и действия: «Создан счет для Tinkoff»

Tinkoff имеет полноценные вебхуки для возврата Автопилоту данных об успешной оплате. Ссылку для вебхука вы можете скопировать в настройках сообщества в Автопилоте. Подойдет ссылка из любого сообщества проекта.

• Для подключения этих вебхуков, скопируйте эту ссылку (на компе достаточно просто кликнуть по ней) и вставьте в Tinkoff в разделе «Настройки» в соответствующее поле.
• Дальше просто используйте событие «Оплатил / сделал перевод», где прописывайте нужное название курса и сумму перевода. Вы можете либо одно такое событие со стандартными параметрами добавить в универсальную команду (продвинутый путь). Либо под каждый продукт создавать отдельную команду и отдельное событие (простой путь).
• Настоятельно также добавлять в команды с этим событием условие:
  числовая переменная %vk_id% больше 0,
  чтобы сервис не присылал вам сообщения об ошибках, если вдруг кто-то купит не через Автопилот.

Готовый пример смотрите на скриншоте ниже:

Переменные действий

В действиях и условиях команды принимающей вебхук (с событием «Оплатил / cделал перевод») можно использовать следующие переменные:

• %vk_product_title% — название товара,
• %vk_product_price% — стоимость товара
• Естественно остальные стандартные переменные Автопилота (%subs_id%, %subs_link%, %first_name% и т. п.) также доступны.