tbi bank Installments для OpenCart 2.3, 3.x и 4.x — оплата частями в Румынии, Болгарии и Греции

tbi bank Installments — модуль оплаты для OpenCart 4.x, 3.x и 2.3, который добавляет оплату частями от tbi bank в Румынии, Болгарии и Греции. Покупатель выбирает рассрочку на чекауте, заполняет заявку на странице tbi, а банк принимает решение и отправляет его в магазин. Модуль меняет статус заказа сам: одобрено, отказ или отменено.

Для работы нужен договор мерчанта с tbi bank: reseller code, reseller key и ключ шифрования выдаёт tbi Merchant Solutions. Адрес, на который tbi будет отправлять решения, модуль показывает в настройках: передайте его менеджеру tbi при подключении.

Что увидит покупатель

На шаге оплаты покупатель видит метод «Pay in installments with tbi bank» с коротким пояснением, что заявка занимает несколько минут и карта не нужна. После подтверждения заказа он переходит на страницу tbi и заполняет заявку.

Если tbi отказал или покупатель отменил заявку, он видит «Installments with tbi bank» с пояснением и кнопкой «Pay another way»: товары возвращаются в корзину, и можно оплатить иначе. В Pro под ценой товара видно, сколько получается ежемесячный платёж через tbi.

Что получает админ

В настройках вы выбираете страну, тестовую или боевую платформу, вводите reseller code, reseller key и ключ шифрования, а кнопка «Check connection» спрашивает tbi о настройках мерчанта. Там же задаются статусы для «заявка отправлена», одобрения, отказа и отмены, лимиты суммы, геозона и тексты для каждого языка.

На странице заказа есть вкладка tbi с номером заявки и состоянием. В истории заказа появляется по одной строке на каждое решение банка. В Pro журнал показывает все заявки с фильтром по состоянию.

Как это работает — шаг за шагом

1. Вы вводите данные доступа от tbi и проверяете соединение.
2. Передаёте менеджеру tbi адрес для решений из настроек.
3. Покупатель выбирает рассрочку на чекауте и переходит на страницу tbi.
4. Модуль отправляет заявку с товарами и суммой заказа.
5. tbi принимает решение и отправляет его в магазин.
6. Модуль расшифровывает решение, проверяет подпись и меняет статус заказа.

Что под капотом

• Заявка шифруется AES-256 ключом мерчанта, как в официальном плагине банка.
• Решение tbi расшифровывается ключом магазина, а подпись HMAC проверяется, если tbi её присылает.
• Неизвестный статус tbi никогда не считается оплатой.
• Сумма строк заявки всегда равна сумме заказа вместе с доставкой и купоном.
• Возврат покупателя со страницы tbi не меняет заказ: решение только от банка.
• В журнал не пишутся имя, почта и телефон покупателя.

Как установить

1. Расширения → Установщик: загрузите архив под свою версию, не меняя имя файла.
2. OpenCart 2.3: Установщик копирует файлы только с включённым FTP. Без FTP скопируйте содержимое upload/ в корень магазина вручную.
3. OpenCart 2.3 и 3.x: Расширения → Модификации → «Обновить».
4. Расширения → Платежи → tbi bank Installments → кнопка установки → Редактировать.
5. Расширения → Платежи → tbi bank Installments: выберите страну и тестовую платформу.
6. Введите reseller code, reseller key и ключ шифрования, нажмите «Check connection».
7. Передайте менеджеру tbi адрес для решений и сделайте тестовую заявку.
8. Для Pro: вставьте ключ или запустите 7 дней триала.