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

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

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

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

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

 

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

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

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

  1. Ввести настройки модуля: Терминал и пароль (их вы можете увидеть в кабинете эквайринга - меню магазины)
  2. На стороне банка в настройках магазина
    уcтановить способ подключения API
    установить тип нотификации 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. Если вы корректировали tpl или twig, то произвести повторные корректировки под свой шаблон
  6. Обновить кэш twig (для магазинов 3.х, главная страница админ панели, кнопка с шестеренкой в правом верхнем углу)

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

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


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

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

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

 

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>

 

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

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

Магазины 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