Документация модуля "СБП Тинькофф"

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку.

Открыть расчетный счет и зарегистрировать СБП вы можете с выгодой (3 месяца бесплатного обслуживания в подарок), для получения бонуса перейдите по ссылке.

Последние версии модулей:
Магазины 1.5 - 1.0 (oc1.5)
Магазины 2.0-2.1 - 1.0 (oc2.0-2.1)
Магазины 2.3 - 2.0 (oc2.3)
Магазины 3.0 - 2.0.1 (oc3.0)

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

  1. Установить модуль artsbptin.ocmod.zip через Установщик модулей
  2. Установить модуль в админ панель -> Дополнения -> Оплата -> ART&PR Система быстрых платежей (СБП Тинькофф) -> Установить

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

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

 

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

  1. Скопировать все из папки Upload в корень сайта
  2. Установить модуль в админ панель -> Дополнения -> Оплата -> ART&PR Система быстрых платежей (СБП Тинькофф) -> Установить

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

  1. Ввести настройки модуля: Терминал и пароль (их вы можете увидеть в кабинете эквайринга - меню магазины) ВНИМАНИЕ! СБП не работает в тестовом режиме, вводить только данные от РАБОЧЕГО терминала (для прохождения тестирования воспользуйтесь официальным модулем тинькофф интернет эквайринг или модулем по ссылке).
  2. На стороне банка в настройках магазина
    уcтановить способ подключения УНИВЕРСАЛЬНОЕ
    Устанавливать нотификации и страницы возврата не нужно, если у вас там чтото уже вписано оставьте старые значения.
  3. На стороне банка в настройках магазина перейдите в раздел способы оплаты
    Активируйте Система быстрых платежей
  4. Выбирете валюту магазина соответствующею вашей валюте счета
  5. Установите разные статусы для ожидаемого и удачного платежа (РАЗНЫЕ)
  6. Установите статус включено (остальные настройки являются не обязательноми и добавляют только дополнительный функционал)
  7. Если необходима передача данных для чека, в настройках используйте параметр Передавать корзину - да, а в настройках кабинета Тинькофф подключите доступную кассу.

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

  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 и не отображается QR
Убедитесь что вы используете последнюю версию модуля.

Ошибки от 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⁩/
tcssbp_fail.tpl
tcssbp_success.tpl
tcssbp.tpl

Магазины 2.3
сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/
tcssbp_fail.tpl
tcssbp_success.tpl
tcssbp_go.tpl

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

Магазины 3.х
Необходимо привести twig модуля в соответвие вашего шаблона (за эталон возьмите common/success.twig)
скопируйте шаблоны модуля сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/
tcssbp_fail.twig
tcssbp_success.twig
tcssbp_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 в соответвии с вашим шаблоном
переименуйте файл в tcssbp.ocmod.xml  и установите через установщик, обновите кеш модификаторов

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