Инструкция по установке и настройке модуля Tinkoff

1. Установка модуля OpenCart

Для установки модуля необходимо:

 

Для приема платежей онлайн через модуль нужно подключить(нажмите на меня) интернет-эквайринг от Тинькофф Кассы".

Внимание! Поддерживаемые версии: 1.5 – 3.0 

1. Распаковать архив с модулем.
2. Скопировать содержимое папки upload в корневую директорию сайта на вашем сервере. Замены файлов происходить не должно.

2. Настройка модуля OpenCart 

2.1. OpenCart 1.5 

Для настройки модуля необходимо:

1. Зайти в административную панель OpenCart и перейти в раздел «Extensions - Payments».
   

   

   Рисунок 1. Расширения модуля
   

2. Найти модуль «Tinkoff Bank» и установить его в разделе «Действие».
   

   

   Рисунок 2. Установка модуля
   

3. Нажать кнопку редактирования.
4. В открывшемся окне указать:
   - Значение «Терминал» в поле «Shop ID»;
   - Значение «Пароль» в поле «Secret Key»;
   
   
   Рисунок 3. Ввод данных
   
5. Для получения данных в личном кабинете нужно:
   a) Перейти в раздел «Магазины».
   b) Выбрать магазин.
   c) Выбрать пункт «Терминалы» в боковом меню.
   

   

   Рисунок 4. Данные терминала

6. Выбрать язык платежной формы.
   

   

   Рисунок 5. Настройка статуса модуля

Внимание!
− Для корректной работы модуля нужно проверить, что директива allow_url_fopen в php.ini включена (allow_url_fopen = On)
− С сервера должен быть доступ до securepay.tinkoff.ru по порту 443. Проверить можно с помощью команды: telnet securepay.tinkoff.ru 443. Если ресурс недоступен, необходимо связаться с хостинг-провайдером и попросить открыть ресурс для отправки запросов

2.2. OpenCart 2.0-2.2

Для настройки модуля необходимо:

1. Перейти в раздел «Дополнения» – «Оплаты» в интерфейсе модуля.
   

   
   Рисунок 6. Выбор модуля
   

2. Найти модуль «Tinkoff Bank» и активировать его в разделе «Действие».
   

   
   Рисунок 7. Активация модуля
   

3. Нажать кнопку редактирования.
4. В открывшемся окне указать:
   − Значение «Терминал» в поле «Номер магазина»;
   − Значение «Пароль» в поле «Секретный ключ»;
   

   
   Рисунок 8. Ввод данных
   

   Для получения данных в личном кабинете нужно:

    a) Перейти в раздел «Магазины».

    b) Выбрать магазин.

    c) Выбрать пункт «Терминалы» в боковом меню

   
   Рисунок 9. Данные терминала
   

5. Настроить статусы заказов, выбрав для каждого статус из списка возможных.
6. Указать порядок сортировки модуля.
   

   

   Рисунок 10. Настройка порядка сортировки модуля
   

7. Выбрать язык платежной формы
8. Изменить статус модуля на «Включено».
   

   

Рисунок 11. Настройка статуса для модуля

2.3. OpenCart 2.3

1. Зайти в административную панель OpenCart и перейти в раздел «Модули/Расширения».
   

   
   Рисунок 12. Расширения модуля
   

2. Выбрать «Оплата» в фильтре на открывшейся странице.
   

   
   Рисунок 13. Выбор типа расширения
   

3. Найти модуль «Tinkoff Bank» и активировать его в разделе «Действие»
   

   
   Рисунок 14. Активация модуля
   

4. Нажать кнопку редактирования.
5. В открывшемся окне редактирования настроек заполнить поля «Терминал» и «Пароль» параметрами для магазина из Личного кабинета: https://oplata.tinkoff.ru. Для этого в ЛК нужно:
   a) Перейти в раздел «Магазины».
   b) Выбрать магазин.
   c) Выбрать пункт «Терминалы» в боковом меню
   

   
   Рисунок 15. Данные терминала
   

   
   Рисунок 16. Параметры модуля
   

6. Настроить статусы заказов, выбрав для каждого статус из списка возможных: https://t.tinkoff.ru/
   

   
   Рисунок 17. Настройка статусов заказа

7. Выбрать язык платежной формы.
8. Выбрать статус для модуля: Включено.
   
   
   Рисунок 18. Настройка статуса для модуля
   
   
   

2.4. OpenCart 3.0:

Для настройки модуля необходимо:

1. Зайти в административную панель OpenCart и перейти в раздел «Extensions» («Расширения»).
   

   
   Рисунок 19. Расширения модуля
   

2. Выбрать «Payments» («Оплата») в фильтре на открывшейся странице.
   

   
   Рисунок 20. Выбор типа расширения
   

3. Найти модуль «Tinkoff Bank Payments» и активировать его в разделе «Action» («Действия»).
   

   
   Рисунок 21. Активация модуля
   

4. Нажать кнопку редактирования.
5. В открывшемся окне редактирования настроек заполнить поля «Terminal» и «Password» («Терминал» и «Пароль») параметрами для магазина из Личного кабинета: https://oplata.tinkoff.ru. Для этого в ЛК нужно: 
   a) Перейти в раздел «Магазины».
   b) Выбрать магазин.
   c) Выбрать пункт «Терминалы» в боковом меню.
   
   
   Рисунок 22. Данные терминала 
   

   
   

   Рисунок 23. Параметры модуля

6. Настроить статусы заказов, выбрав для каждого статус из списка возможных: https://t.tinkoff.ru/ 
   

   
   Рисунок 24. Настройка статусов заказа
   

7. Выбрать язык платежной формы.
8. Выбрать статус для модуля: Enabled (Включено).
   

   
   Рисунок 25. Настройка статуса для модуля
   
   

3. Настройка интеграции с онлайн-кассами в модуле

3.1. OpenCart 1.5

Для интеграции с онлайн-кассами необходимо:

1. Выбрать пункт «Send data to a cheque» в настройках модуля. Если используется ФФД 1.2, то выбрать пункт «Receipt in FFD 1.2 format». Важно! Не включайте этот пункт, если вы используете чеки в старом формате.
   

   
   Рисунок 26. Согласие на передачу данных
   

2. Выбрать систему налогообложения для магазина в раскрывающемся меню «Taxation». 
   

   
   Рисунок 27. Выбор системы налогообложения
   

Внимание!

Для корректной передачи данных чека в онлайн-кассу необходимо:
− выставить для всех товаров магазина корректную ставку НДС,
− указать в настройках модуля систему налогообложения и ставку налога для доставки в настройках доставки.
 Доставка будет добавлена в чек отдельной позицией!

Внимание!   Сумма к оплате корректно рассчитывается только при использовании стандартных (встроенных в CMS) способов доставки.

Налоговая ставка указывается в разделе «System» -> «Localisation» -> «Taxes» -> «Tax Rates».

Рисунок 28. Налоговая ставка 

Ставка НДС указывается для налогового класса в разделе «System» -> «Localisation» -> «Taxes» -> «Tax Classes».

Рисунок 29. Ставка для налогового класса

Внимание! Для одного налогового класса должна быть указана только одна ставка НДС.

Для товара налог указывается в настройках товара: в поле «Налог» нужно указать нужный налоговый класс.

Рисунок 30. Выбор налогового класса для товара

Для доставки налог указывается в настройках доставки: в поле «Класс налога» нужно указать нужный налоговый класс.

Рисунок 31. Выбор налогового класса для доставки

1. Выбрать пункт «Передавать данные для формирования чека» в настройках модуля.
   

   
   Рисунок 32. Согласие на передачу данных
   
   

2. Если используется ФФД 1.2, то выбрать пункт «Чек версии ФФД 1.2». Важно! Не включайте этот пункт, если вы используете чеки в старом формате.
   

   
   
   

3. Выбрать систему налогообложения для магазина в раскрывающемся меню «Система налогообложения».
   
   
   Рисунок 33. Выбор системы налогообложения
   
   

   Внимание! Для корректной передачи данных чека в онлайн-кассу необходимо:
   − выставить для всех товаров магазина корректную ставку НДС,
   − указать в настройках модуля систему налогообложения и ставку налога для доставки в настройках доставки.
   
   Доставка будет добавлена в чек отдельной позицией!
   
   Внимание! Сумма к оплате корректно рассчитывается только при использовании стандартных (встроенных в CMS) способов доставки.
   
   Налоговая ставка указывается в разделе «Система» -> «Локализация» -> «Налоги» -> «Ставки налогов».
    
   
   
   Рисунок 34. Налоговая ставка
   
   

   Ставка НДС указывается для налогового класса в разделе «Система» -> «Локализация» -> «Налоги» -> «Классы налогов».
   
   
   Рисунок 35. Ставка для налогового класса
   
   

   Внимание! Для одного налогового класса должна быть указана только одна ставка НДС.
   
   Для товара налог указывается в настройках товара: в поле «Класс налога» указать нужный налоговый класс (Каталог – Товары – Изменить – вкладка «Данные»).
   
   
   Рисунок 36. Выбор налогового класса для товара
   
   

   Для доставки налог указывается в настройках доставки: в поле «Класс налога» указать нужный налоговый класс (Дополнения – Доставка – Редактировать).
   
   
   Рисунок 37. Выбор налогового класса для доставки
   
   

1. Выбрать пункт «Передавать данные для формирования чека» в настройках модуля.
   

   
   Рисунок 38. Согласие на передачу данных
   

2.  Если используется ФФД 1.2, то выбрать пункт «Чек в формате ФФД 1.2». Важно! Не включайте этот пункт, если вы используете чеки в старом формате.
   

   
   
   

3. Выбрать систему налогообложения для магазина в раскрывающемся меню «Система налогообложения».
   

   
   Рисунок 39. Выбор системы налогообложения
   

Внимание! Для корректной передачи данных чека в онлайн-кассу необходимо:
− выставить для всех товаров магазина корректную ставку НДС,
− указать в настройках модуля систему налогообложения и ставку налога для доставки в настройках доставки. 

Доставка будет добавлена в чек отдельной позицией!

Внимание! Сумма к оплате корректно рассчитывается только при использовании стандартных (встроенных в CMS) способов доставки. 

Налоговая ставка указывается в разделе «Система» -> «Локализация» -> «Налоги» -> «Налоговые ставки».

Рисунок 40. Налоговая ставка

Наименования ставок НДС для товаров должны быть следующего вида:  
− «Без НДС» - ставка 0%;
− «НДС 0» - ставка 0%;
− «НДС 10%» - ставка 10%;
− «НДС 18%» - ставка 18%. 

Ставка НДС указывается для налогового класса в разделе «Система» -> «Локализация» -> «Налоги» -> «Налоговый класс».

Рисунок 41. Ставка для налогового класса

Внимание! Для одного налогового класса должна быть указана только одна ставка НДС. 

Для товара налог указывается в настройках товара: в поле «Налог» нужно указать нужный налоговый класс.

Рисунок 42. Выбор налогового класса для товара 

Для доставки налог указывается в настройках доставки: в поле «Класс налога» нужно указать нужный налоговый класс.

Рисунок 43. Выбор налогового класса для доставки

3.4. OpenCart 3.0

Для интеграции с онлайн-кассой необходимо:

1. Выбрать значение «Yes» («Да») в пункте «Send data to a cheque» («Передавать данные для формирования чека») в настройках модуля.
   

   

   Рисунок 44. Согласие на передачу данных
   

2. Если используется ФФД 1.2, то выбрать пункт «Чек версии ФФД 1.2». Важно! Не включайте этот пункт, если вы используете чеки в старом формате.
   

   

3. Выбрать систему налогообложения для магазина в раскрывающемся меню «The system of taxation» («Система налогообложения»).
   

   
   Рисунок 45. Выбор системы налогообложения
   

Внимание! Для корректной передачи данных чека в онлайн-кассу необходимо:
− выставить для всех товаров магазина корректную ставку НДС,
− указать в настройках модуля систему налогообложения и ставку налога для доставки в настройках доставки. 

Доставка будет добавлена в чек отдельной позицией!

Внимание! Сумма к оплате корректно рассчитывается только при использовании стандартных (встроенных в CMS) способов доставки.

Налоговая ставка указывается в разделе «System» -> «Localization» -> «Taxes» -> «Tax Rates» («Система» -> «Локализация» -> «Налоги» -> «Налоговые ставки»).

Рисунок 46. Налоговая ставка

Наименования ставок НДС для товаров должны быть следующего вида:
− «Без НДС» - ставка 0%;
− «НДС 0» - ставка 0%;
− «НДС 10%» - ставка 10%;
− «НДС 18%» - ставка 18%. 

Ставка НДС указывается для налогового класса в разделе «System» -> «Localization» -> «Taxes» -> «Tax Classes» («Система» -> «Локализация» -> «Налоги» -> «Налоговый класс»).

Рисунок 47. Ставка для налогового класса

Внимание! Для одного налогового класса должна быть указана только одна ставка НДС.

Для товара налог указывается в настройках товара. Для этого необходимо:

1. Перейти в раздел «Products» (Товары).
2. Выбрать товар и нажать кнопку редактирования.
3. На вкладке «Data» («Данные») в поле «Tax class» («Налог») указать нужный налоговый клаcc.
   

   

   Рисунок 48. Выбор налогового класса для товара
   

Для доставки налог указывается в настройках доставки. Для этого необходимо:

1. Перейти в раздел «Extensions» («Расширения»).
2. Выбрать тип расширения «Shipping» («Доставка»).
3. Выбрать вид доставки и нажать кнопку редактирования.
4. В поле «Tax Class» («Класс налога») указать нужный налоговый класс.
   

   
   Рисунок 49. Выбор налогового класса для доставки
   
   

4. Настройка магазина в Личном Кабинете 

Для настройки магазина в ЛК необходимо:

1. Перейти в раздел «Магазины» и выбрать магазин.
2. В боковом меню выбрать пункт «Терминалы» и нажать кнопку НАСТРОИТЬ для терминала.
   

   
   Рисунок 50. Боковое меню
   

3. Выполнить следующие настройки:
   a) Выбрать способ подключения: «Универсальное подключение».
   b) Выбрать пункт: Нотификация по http(s). 
   Внимание! URL для нотификации по http:
   OpenCart 1.5: <название_сайта>/index.php?route=payment/tinkoff/notification
   OpenCart 2.0-2.2: <название_сайта>/index.php?route=payment/tinkoff/callback
   OpenCart 2.3 и 3.0: <адрес сайта>/index.php?route=extension/payment/tinkoff/callback
4. Если вы хотите использовать:
   a) стандартные страницы успешного/неуспешного платежа, оставьте значения по умолчанию в полях URL страницы успешного/неуспешного платежа.
   b) страницы успешного/неуспешного платежа, расположенные на вашем сайте, необходимо выбрать тип страницы «Собственная страница» и прописать следующие значения:
   − URL страницы успешного платежа:   
      OpenCart 1.5, 2.0-2.2: <название_сайта>/index.php?route=payment/tinkoff/success
      OpenCart 2.3: <адрес сайта>/index.php?route=checkout/success
      OpenCart 3.0: <адрес сайта>/index.php?route=extension/payment/tinkoff/success 
   − URL страницы неуспешного платежа: 
      OpenCart 1.5, 2.0-2.2: <название_сайта>/index.php?route=payment/tinkoff/failure
      OpenCart 2.3: <адрес сайта>/index.php?route=extension/payment/tinkoff/failure
      OpenCart 3.0: <адрес сайта>/index.php?route=extension/payment/tinkoff/failure
   Внимание! Для OpenCart 3.0 корзина очищается только при использовании собственных страниц

5. На.стройка интеграции с онлайн-кассами в Личном кабинете (oplata.tinkoff.ru)

Для настройки интеграции с онлайн-кассой в ЛК необходимо:

1. Выбрать магазин в разделе «Магазины».
2. В открывшемся окне выбрать пункт «Онлайн-Касса» в меню слева.
3. Выполнить тест-кейсы №7 и 8.
4. Ввести данные онлайн-кассы после успешного выполнения тест-кейсов
   

   
   Рисунок 52. Ввод учетных данных
   

5. Включить переключатель «Передача данных». Он отображается на странице при корректном вводе данных.
   

   
   Рисунок 53. Переключатель "Передача данных"
   

6. Передача данных в онлайн-кассу активирована. С этого момента информация о каждой операции передается в онлайн-кассу.