Интеграция платежного модуля с 1C-Битрикс

License: Apache 2.0

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

Поддерживаемые версии 16-23
Поддержка онлайн-кассы Да
Файл модуля
v2.5.2
Скачать

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

  1. Загрузить модуль на сайт одним из способов ниже:
    • Скачать архив с модулем из таблицы выше.
      1. Распаковать архив. Перейти в папку модуля, соответствующую кодировке на сайте (utf-8 или win-1251).
      2. Скопировать папку tinkoff.payment и все ее содержимое на ваш сервер в директорию \bitrix\modules\.
    • Загрузить модуль через marketplace.
      1. Открыть административную панель сайта: Marketplace → Каталог решений → в поиске найти «Модуль приема платежей Т‑Банк» → Установить
  2. Перейти в раздел Marketplace → Установленные решения.
  3. Выбрать модуль «Т‑Банк (tbank.payment)» и нажать кнопку Установить.

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

Для интернет-магазинов формирование ссылки будет происходит через интерфейс 1C-Битрикс.
Для магазинов выставления счёта - только через ЛК ИЭ.

Возврат (отмена платежа) проводится только через личный кабинет ИЭ.

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

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

  1. Перейти в раздел «Магазин» → «Платежные системы», найти платежную систему «Т‑Банк» и нажать Изменить.
  2. Заполнить поля «Сортировка», «Описание» и поставить флаг «Активность».
  3. Снять все чекбоксы «по умолчанию» на вкладке «По умолчанию».
    Внимание! На вкладке «Физическое лицо» у всех параметров должны быть выставлены чекбоксы «По умолчанию».

  4. Заполнить поля «Терминал» и «Пароль» параметрами для магазина из Личного кабинета. Для этого в ЛК нужно:
    1. Перейти в раздел «Магазины».
    2. Выбрать магазин.
    3. Выбрать пункт «Терминалы» в боковом меню.
  5. Выбрать язык платежной формы.
  6. Нажать Сохранить.

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

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

  1. Выбрать «Да» в раскрывающемся меню «Передавать данные для формирования чека» в настройках платежной системы.
  2. При необходимости выберите пункт «Чек в формате ФФД 1.2». Важно! Не включайте этот пункт, если вы используете чеки в старом формате.
  3. Выбрать систему налогообложения магазина в раскрывающемся меню «Система налогообложения».
  4. Выбрать необходимую ставку налога для доставки для передачи в чек в списке «Ставка налога для доставки».
  5. Выбрать признак способа расчета. Подробнее о признаке способа расчета
  6. Настроить признак предмета расчета. Подробнее о признаке предмета расчета

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

Доставка добавляется в чек отдельной позицией!
Наименования ставок НДС для товаров должны быть следующего вида:
— «Без НДС» - ставка 0%;
— «НДС 0» - ставка 0%;
— «НДС 10%» - ставка 10%;
— «НДС 20%» - ставка 20%;
— «НДС 5%» - ставка 5%;
— «НДС 7%» - ставка 7%.

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

  1. Создать ставку (Магазин – Налоги – Ставки НДС – кнопка +Добавить).
  2. Применить созданную ставку. Есть два способа:
  • Выбрать ставку в разделе Настройки – Настройки продукта – Настройки модулей - Торговый каталог – Каталоги.
    Внимание! Ставка НДС будет применена ко всему каталогу.
  • Выбрать ставку на вкладке «Цены». (Контент – Каталоги – Каталог – Подраздел – Товар – Изменить – Торговый каталог – Цены)
    Внимание! Ставка НДС будет применена ко всему каталогу.

Настройка магазина в ЛК Т‑Банка

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

  1. Перейти в раздел «Магазины» и выбрать магазин.
  2. В боковом меню выбрать пункт «Терминалы» и нажать кнопку Настроить для терминала.
  3. Выполнить следующие настройки:
    • Выбрать способ подключения: «Универсальное подключение».
    • Выбрать пункт: Нотификация по http(s).
      Внимание! URL для нотификации по http(s): <название_сайта>/personal/order/notification.php
  4. Если вы хотите использовать:
    • Стандартные страницы успешного/неуспешного платежа, оставьте значения по умолчанию в полях URL страницы успешного/неуспешного платежа.
    • Страницы успешного/неуспешного платежа, расположенные на вашем сайте, необходимо выбрать тип страницы «Собственная страница» и прописать следующие значения:
      • URL страницы успешного платежа: <название_сайта>/personal/order/success.php
      • URL страницы неуспешного платежа: <название_сайта>/personal/order/failed.php
  5. Нажать кнопку Сохранить.

Настройка интеграции с онлайн-кассами в ЛК Т‑Банка

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

  1. Выбрать магазин в разделе «Магазины».
  2. В открывшемся окне выбрать пункт «Онлайн-Касса» в меню справа.
  3. Выполнить тест-кейсы №7 и 8.
  4. Ввести данные онлайн-кассы после успешного выполнения тест-кейсов.
  5. Включить переключатель «Передача данных». Он отображается на странице при корректном вводе данных.
  6. Передача данных в онлайн-кассу активирована. С этого момента информация о каждой операции передается в кассу.

Обратная связь

По техническим вопросам обратитесь на почту acq_help@tbank.ru.
Для предоставления обратной связи и по вопросам улучшения обслуживания и предоставляемого сервиса обратитесь к вашему личному менеджеру