Документация Тинькофф Эквайринг PRO

Магазины версии 3.0 Установка:

  1. Установить модуль через Установщик модулей
  2. Установить модуль в админ панель -> Дополнения -> Оплата -> Тинькофф Эквайринг - Двухстадийная оплата -> Установить

Магазины версии 2.0-2.3 Установка:

  1. Установить модуль через Установщик модулей, в модификациях (менеджер дополнений) нажать обновить кэш модификаторов (кнопка со стрелками по кругу, в правом верхнем углу)
  2. Установить модуль в админ панель -> Дополнения -> Оплата -> Тинькофф Эквайринг - Двухстадийная оплата -> Установить
  3. Если вы не видите модуль то воспользуйтесь фиксом или установкой вручную

 

Магазины версии 1.5  Установка:

  1. Скопировать все из папки Upload в корень сайта
  2. Установить модуль в админ панель -> Дополнения -> Оплата -> Тинькофф Эквайринг - Двухстадийная оплата -> Установить

Настройка модуля:

  1. Ввести настройки модуля: Терминал и пароль (их вы можете увидеть в кабинете эквайринга - меню магазины)
  2. На стороне банка в настройках магазина
    уcтановить способ подключения УНИВЕРСАЛЬНОЕ
    установить тип нотификации HTTP (или HTTP + email если вы хотите получать еще дополнительное письмо на почту от банка)
    установить URL уведомлений который указан в настройках модуля - пункт callback (данный параметр будет влиять на смену статуса заказа, также в настройках модуля вы можете выбрать создание заказа до оплаты или после)
    если вы хотите использовать специальные страницы удачного и не удачного платежа от модуля то установите URL страницы вида Пользовательский

    для магазинов 1.5, 2.0, 2.1, 2.2
    удачный платеж - адрес_сайта/index.php?route=account/tcsacquiring/success
    неудачный платеж - адрес_сайта/index.php?route=account/tcsacquiring/fail

    для магазинов 2.3, 3.x
    удачный платеж - адрес_сайта/index.php?route=extension/payment/tcsacquiring/success
    неудачный платеж - адрес_сайта/index.php?route=extension/payment/tcsacquiring/fail

    адрес_сайта указывать в полном формате включая протокол (http://site.ru или https://site.ru)
     
  3. также вы можете использовать стандартные адреса магазина
    удачный платеж - адрес_сайта/index.php?route=checkout/success
    неудачный платеж - адрес_сайта/index.php?route=checkout/failure

    для 1.5
    неудачный платеж - адрес_сайта/index.php?route=checkout/checkout

    адрес_сайта указывать в полном формате включая протокол (http://site.ru или https://site.ru)
     
  4. ВНИМАНИЕ! НАСТРОЙКИ ТЕРМИНАЛА ТЕСТОВОГО и РАБОЧЕГО необходимо указывать одинаковые.
    ОБЯЗАТЕЛЬНО УБЕДИТЕСЬ ЧТО НАСТРОЙКИ В ТЕРМИНАЛЕ СОХРАНИЛИСЬ И ФОРМАТ ССЫЛКОК КОРРЕКТЕН
  5. Если Вы хотите принимать двухстадийные платежи то отметьте галку Подтверждать платежи из личного кабинета в НАСТРОЙКАХ МАГАЗИНА ТИНЬКОФФ и НАСТРОЙКАХ МОДУЛЯ установите двухстадийные платежи.
  6. В настройках модуля выбирите тип платежей одностадийные или двухстадийные
  7. Выбирете валюту магазина соответствующею вашей валюте счета
  8. Установите разные статусы для ожидаемого и удачного платежа (РАЗНЫЕ)
  9. Установите статус включено (остальные настройки являются не обязательноми и добавляют только дополнительный функционал)
  10. Если необходима передача данных для чека, в настройках используйте параметр Передавать корзину - да, а в настройках кабинета Тинькофф подключите доступную кассу.

 

Обновление версии модуля

  1. Удалить модификатор (для магазинов 2.х)
  2. Провести полную установку с заменой файлов
  3. Ввести в настройки повторно пароль терминала
  4. В настройках терминала в кабинете банка установить адрес уведомлений который указан в настройках модуля
  5. Пересохранить настройки модуля
  6. Если вы корректировали tpl или twig, то произвести повторные корректировки под свой шаблон
  7. Обновить кэш twig (для магазинов 3.х, главная страница админ панели, кнопка с шестеренкой в правом верхнем углу)

Подключение онлайн-кассы

Для работы без дополнительных модулей зарегистрируйте кассу Атол-онлайн по ссылке (если вы выбрали урезанный тариф без офд, зарегистрируйте ОФД.РУ по ссылке), либо зарегисрируйте кассу FERMA в ОФД.РУ, зарегисрируйте кассу в фнс
Подключите кассу в кабинете тинькофф в разделе магазин, если вы не видите нужную кассу обратитесь в поддержку тинькофф

Режим работы Отложенная оплата

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


Для активации оплаты, необходимо в просмотре(не редактировании) заказа установить статус из настроек модуля - Статус для активации

Отложенной оплаты и установить галку уведомить покупателя, нажать кнопку добавить историю
В версиях магазинов 2.х, для работы отложенной оплаты обязательно наличие модификатора в разделе Менеджер дополнений(Модификаторы) и обновленный кеш модификаторов (там же кнопка вверху стрелки по кругу)

Покупатель получит ссылку в письме о смене статуса заказа (поддерживается стандартное опенкартовское письмо о смене статуса заказа, если вы используете модуль шаблонов то ссылки может не быть) и в кабинете покупателя, если покупатель зарегистрирован появится ссылка на оплату (поддерживается стандартный шаблон кабинета, при отсутвии кнопки читайте faq)

 

Настройка признака способа и предмета расчета

В настройках модуля укажите Признак способа и предмета расчета - эти данные будут использоваться по умолчанию если вы выберите Признак предмета и/или способа для товара - пункт по умолчанию

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

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

Для значений в карточке товара указываете в нужном поле одно из следующих значиний

Признак предмета расчета

Значение Описание
commodity Товар
excise Подакцизный товар
job Работа
service Услуга
gambling_bet Ставка в азартной игре
gambling_prize Выигрыш в азартной игре
lottery Лотерейный билет
lottery_prize Выигрыш в лотерею
intellectual_activity Результаты интеллектуальной деятельности
payment Платеж
agent_commission Агентское вознаграждение
composite Несколько вариантов
another Другое

 

Признак способа расчета

Значение Описание
full_prepayment Полная предоплата
prepayment Частичная предоплата
advance Аванс
full_payment Полный расчет
partial_payment Частичный расчет и кредит
credit Кредит
credit_payment Выплата по кредиту

 

FAQ

1.  При переходе на оплату текст No Data
Убедитесь что вы используете последнюю версию модуля.
В настройках модуля включите режим отладки, последняя строчка - это ошибка от Тинькофф банк

Также ошибки от No Data доступны в журнале магазина без включения режима отладки. Если строчка ошибки пустая TCSBank error: и нет далее текста, то это означает что соединение с банком не произошло.

Самая частая ошибка это ошибка в номере терминала или пароле, убедитесь что они корректны и нет пробелов в начале или в конце.

 

2. Как добавить иконку к методу оплаты

 

     В настройках модуля

     поле название метода оплаты добавить тег img (что такое тэг img и как он работает описано по ссылке)

     <img src="путь к картинке" /> Банковские карты

3. Некорректно отображаются страницы успешной, неуспешной оплаты и страница повторной оплаты

Магазины 1.5, 2.0, 2.1, 2.2
Необходимо привести tpl модуля в соответвие вашего шаблона (за эталон возьмите common/success.tpl)
сatalog⁩/view⁩/theme⁩/default⁩/template⁩/account⁩/
tcsacquiring_fail.tpl
tcsacquiring_success.tpl
tcsacquiring.tpl

Магазины 2.3
сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/
tcsacquiring_fail.tpl
tcsacquiring_success.tpl
tcsacquiring_go.tpl

скопируйте шаблоны модуля в папку вашего шаблона по соответвующему пути, исправте верстку в них под ваш шаблон

Магазины 3.х
Необходимо привести twig модуля в соответвие вашего шаблона (за эталон возьмите common/success.twig)
скопируйте шаблоны модуля сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/
tcsacquiring_fail.twig
tcsacquiring_success.twig
tcsacquiring_go.twig
в папку вашего шаблона по соответвующему пути, исправте верстку в них под ваш шаблон

4. Не отображается ссылка повторной оплаты в личном кабинете

Если вы не используете отложенную оплату то ссылку можно добавить в просмотр заказа, для этого в настройках модуля добавьте инструкцию в письме, укажите в поле переменную $href$
можно обернуть в теги
<a href="$href$" class="btn btn-primary">Оплатить онлайн</a>

5. ApplePay и GooglePay
В настройках магазина на стороне тинькофф перейдите в раздел способы оплаты
Активируйте ApplePay на платежной форме? GooglePay на платежной форме

6. Система быстрых платежей (оплата по qr коду)
В настройках магазина на стороне тинькофф перейдите в раздел способы оплаты
Активируйте Система быстрых платежей

 

Для вывода кнопки в списке всех заказов или для отложенной оплаты

Исправления под шаблон

Магазины 1.5
Отредактируйте xml файл из папки vqmod
блок catalog/view/theme/*/template/account/order_list.tpl в соответвии с вашим шаблоном

Магазины 2.0, 2.1, 2.2, 2.3
Удалите модификатор, откройте архив модуля файл instal.xml
отредактируйте блок catalog/view/theme/*/template/account/order_list.tpl в соответвии с вашим шаблоном
переименуйте файл в tcsacquiring.ocmod.xml  и установите через установщик, обновите кеш модификаторов

Магазины 3.х
отредактируйте сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/tcsacquiring_aclink.twig
обновите кеш шаблонов twig