Как интегрировать модуль «Битрикс»

Как проходит интеграция сервиса в Битрикс?

Для этого у нас есть специальный модуль. Его можно скачать и установить бесплатно по нашим подробным инструкциям.

Модуль встраивается в несколько этапов:

1. Установка модуля.
2. Настройка платежной системы.
3. Переход в магазин после оплаты.
4. Изменение статуса оплаты заказа.
5. Тестовый и боевой режим работы.
6. Работа с рассрочками.

Как установить модуль «Битрикс»?

Следуйте этой инструкции:

1. Скачайте архив модуля ZIP.
2. Загрузите архив модуля на сайт. Это можно сделать по FTP в /bitrix/modules/ или через административную часть интернет-магазина: «Контент» → «Структура сайта» → «Файлы и папки». После этого выберите нужный сайт, если у вас их несколько.

3. Нажмите «Загрузить файл» → «Добавить файл» → «Сохранить».

   

4. Распакуйте архив. В результате появятся два архива для разных кодировок сайта: utf8 и cp1251. Выберите архив с нужной кодировкой и его тоже распакуйте. В итоге появится папка tinkoff.creditbroker.

   

5. Установите модуль: Marketplace → «Установленные решения». Там увидите модуль «Рассрочки и кредиты от Т‑Банк»: кликните на иконку гамбургера и выберите «Установить».

   

Готово. После установки модуля в Битриксе появится новая платежная система. Ее нужно включить и настроить.

Как настроить платежную систему в модуле «Битрикс»?

По этой инструкции:

1. Зайти в административную часть интернет-магазина: <ваш сайт>/bitrix/admin.
2. Перейдите к разделу «Магазин» → «Настройки» → «Платежные системы».
3. Нажмите «Добавить платежную систему».

   

4. Выберите обработчик платежной системы «Т‑Рассрочка (tcb)» в выпадающем меню.
5. Отредактируйте поля «Заголовок» и «Описание», если нужно. Эту информацию увидят покупатели при выборе способа оплаты.

6. Не ставьте галочку в чекбоксе «Открывать в новом окне». Поля «Кодировка» и «Код» оставьте пустыми.

   

7. Заполните «Настройки подключения»:

   • shopID и showcaseID скопируйте по инструкции;
   • пароль для интеграции API скопируйте в личном кабинете руководителя → «Магазины» → нужный магазин → «Интеграция» → «API» → «Создать пароль». Перейти в раздел «Магазины»

   Если у вас нестандартная структура и компонент sale.order.payment не находится по адресу /personal/order/payment/, то снимите галку «По умолчанию» и укажите путь до страницы, где установлен компонент sale.order.payment. О компоненте

   

8. Нажмите «Сохранить». Готово!

Вот как это сделать:

1. Зайдите в административную часть интернет-магазина: <ваш сайт>/bitrix/admin.
2. Перейдите на страницу «Магазин» → «Настройки» → «Платежные системы».
3. Перейдите к настройкам платежной системы двойным нажатием на «Т‑Рассрочка».
4. Нажмите «Добавить ограничение» во вкладке «Ограничения».

5. Выберите «По типу плательщика» и установите тип «Физическое лицо (1)».

   

6. Нажмите «Сохранить». Готово!

Как настроить переход в магазин после оплаты?

Он устанавливается по умолчанию. Страница перехода в магазин после успешной оплаты или отказа по умолчанию: /personal/orders/#ORDER_NUMBER#. По ней покупатель переходит на страницу заказа. Это нужно задать в настройках платежной системы: «Настройки обработчика ПС» → «Остальное».

Если нужна страница возврата, ее можно создать в настройках модуля «Интернет-магазин». После создания укажите ее адрес в настройках платежной системы.

Как настроить автоматическое изменение статуса оплаты заказа?

Для этого настройте отправку уведомлений по HTTP. Следуйте инструкции:

1. В личном кабинете руководителя перейдите в раздел «Магазины».
2. Выберите нужный магазин из списка или найдите его в поиске.
3. В карточке магазина перейдите в раздел «Уведомления».

4. Нажмите переключатель «HTTP⁠-⁠уведомления о статусе заявки» — он станет желтым.

   

5. В поле «Ссылка для HTTP⁠-⁠нотификации (webhook URL)» вставьте адрес в формате <адрес вашего сайта>/bitrix/tools/tcbroker_sale_ps_result.php.

   Найти адрес можно в личном кабинете Битрикса. Скопируйте его из блока «Обработчик» в Параметрах платежной системы.

   

Готово. Когда статус оплаты заказа изменится, вам придет уведомление.

Как проверить тестовый и боевой режимы работы?

По умолчанию модуль настраивается в деморежиме: в нем можно протестировать новый способ оплаты.

Для деморежима можно настроить четыре флоу‑заявки, чтобы на них проверить работу сервиса рассрочек:

• подписание по СМС;
• подписание на встрече;
• отказ банка;
• отказ на встрече.

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

1. Зайти в административную часть интернет-магазина: <ваш сайт>/bitrix/admin.
2. Перейти на страницу «Магазин» → «Настройки» → «Платежные системы».
3. Перейдите к настройкам платежной системы двойным нажатием на строку «Т‑Рассрочка».
4. В «Настройках обработчика ПС» снимите галочку «Деморежим».
5. Нажмите «Сохранить». Готово!

Как настроить работу с рассрочками?

По умолчанию модуль настраивается на работу с кредитами: промокод default. Если вы планируете работать с рассрочками, вот что нужно сделать:

1. Зайдите в административную часть интернет-магазина: <ваш сайт>/bitrix/admin.

2. Перейдите на страницу «Магазин» → «Настройки» → «Платежные системы». Дважды нажмите на строку «Т‑Рассрочка».
3. В блоке «Обработчик» нажмите «Настройки промокодов».
4. Укажите промокоды, которые нужно скопировать из раздела «Рассрочки и кредиты» в личном кабинете руководителя. Перейти в «Рассрочки и кредиты»

5. Нажмите «Сохранить».

   

6. Кредитные продукты появятся в «Настройках обработчика ПС». Там их можно включать и выключать без удаления промокода и настроек.

   

Готово, вы настроили модуль для работы с рассрочками.

Кнопки для модуля можно скачать по ссылкам:

Скачать кнопку для рассрочек PNG

Скачать кнопку для кредитов PNG

Другие варианты кнопок можно найти в гайдбуке PDF.

Вот как сменить логотип:

1. Зайдите в административную часть интернет-магазина: <ваш сайт>/bitrix/admin.
2. Перейдите на страницу «Магазин» → «Настройки» → «Платежные системы».
3. Перейдите к настройкам платежной системы двойным нажатием на строку «Т‑Рассрочка».

4. Нажмите «Добавить файл» рядом с «Логотипом платежной системы». Выберите скачанный файл с нужным логотипом. Нажмите «Сохранить».

   

   Готово, вы сменили логотип.

   Если у вас остались вопросы о работе модуля и сервиса «Т⁠-⁠Рассрочка», можете задать их по телефону 8 800 533‑90‑49.