Інтеграція 1С-Бітрікс з Тінькофф Кредит
Покупець додав товар за $720–1kів у кошик, але не готовий платити одразу. Якщо на сторінці оформлення замовлення є кнопка «Купити в кредит», конверсія на дорогих товарах зростає на 15–25%. При середньому чеку від $270–390ів така інтеграція окупається за 2-3 місяці. Тінькофф Кредит — частий вибір інтернет-магазинів в Україні. Інтеграція з 1С-Бітрікс технічно нескладна, але містить нюанси, критичні для працездатності.
Ми реалізуємо таку інтеграцію під ключ за 3–7 днів, включаючи налаштування віджета на сторінці товару та повне тестування всіх сценаріїв. Наш досвід — понад 20 успішних проектів з інтеграції платіжних систем. Готові модулі економлять час, але кастомний обробник дає повний контроль над логікою та сумісністю з іншими платіжними системами — різниця в трудозатратах 3–5 разів.
Чому кастомний обробник кращий за готовий модуль?
Готові модулі з Маркетплейсу встановлюються за годину, але їхні можливості обмежені. Кастомний обробник, написаний з нуля, не тільки налаштовується під будь-які бізнес-процеси, але й легко тестується. При середній вартості інтеграції від $600–1.5kів різниця в гнучкості того варта. Наприклад, ви можете додати власну логіку знижок або перевірки кредитної історії.
Коли підключати віджет на сторінці товару?
Віджет Тінькофф показує приблизний щомісячний платіж прямо в картці товару. Це підвищує конверсію на 10–20% для позицій дорожче $180–260ів. Ми рекомендуємо підключати його для всіх товарів з високою маржинальністю.
Як працює Тінькофф Кредит
Процес з боку покупця:
- Обирає товар → натискає «Купити в кредит»
- Перенаправляється на форму Тінькофф, заповнює заявку
- Тінькофф приймає рішення (1–15 хвилин)
- При схваленні — гроші перераховуються магазину, покупець отримує товар
З боку магазину це платіжна система з відкладеним підтвердженням. Тінькофф надає API, через який магазин створює заявку на кредит, передає дані про товари та суму, отримує посилання для редиректу покупця.
Підключення: договір та налаштування
Перед технічною інтеграцією потрібен партнерський договір з Тінькофф. Після підписання ви отримуєте:
- shopId — ідентифікатор магазину
- showcaseId — ідентифікатор вітрини (можливо декілька для різних типів кредиту/розстрочки)
- API-ключ — для авторизації запитів
- Доступ в особистий кабінет партнера — для моніторингу заявок
Технічна інтеграція
У 1С-Бітрікс Тінькофф Кредит підключається як платіжна система модуля sale. Є два шляхи.
| Параметр | Готовий модуль | Кастомний обробник |
|---|---|---|
| Час встановлення | 1–2 години | 3–5 днів |
| Гнучкість налаштувань | Обмежена | Повний контроль |
| Перевірка підпису | Вбудована | Реалізується вручну |
| Сумісність з іншими системами | Може конфліктувати | Без обмежень |
Шлях 1: готовий модуль з Маркетплейсу
На marketplace.1c-bitrix.ru є декілька модулів для Тінькофф Кредит. Встановлюєте модуль, вводите shopId, showcaseId, API-ключ в налаштуваннях платіжної системи (Магазин → Налаштування → Платіжні системи). Модуль створює обробник \Sale\Handlers\PaySystem\TinkoffCredit та реєструє callback-URL для сповіщень.
Шлях 2: кастомний обробник платіжної системи
Якщо готові модулі не влаштовують (застаріли, немає потрібних функцій, конфліктують), пишемо обробник з нуля.
Структура обробника в /local/php_interface/include/sale_payment/tinkoff_credit/:
handler.php — клас обробника .description.php — метадані для адмінки .settings.php — список налаштувань (shopId, showcaseId, apiKey) template/ — шаблон кнопки оплати Клас обробника наслідується від \Bitrix\Sale\PaySystem\ServiceHandler та реалізує методи:
-
initiatePay— формує запит до API Тінькофф, створює заявку, повертає URL для редиректу -
processRequest— обробка callback від Тінькофф при зміні статусу заявки -
getPaymentIdFromRequest— вилучення ID платежу з вхідного сповіщення
Формування заявки
Запит до API Тінькофф містить:
{ "shopId": "your_shop_id", "showcaseId": "your_showcase_id", "orderNumber": "BX_ORDER_123", "customerInfo": { "email": "[email protected]", "mobilePhone": "+79001234567" }, "items": [ { "name": "Ноутбук Lenovo ThinkPad", "quantity": 1, "price": 80000, "category": "electronics" } ], "sum": 80000, "returnUrl": "https://shop.ru/personal/order/detail/{ORDER_ID}/", "failUrl": "https://shop.ru/personal/order/detail/{ORDER_ID}/?fail=1", "postLink": "https://shop.ru/bitrix/tools/sale_ps_result.php" } Згідно з документацією Тінькофф, товарні позиції обов'язкові для скорингу — заявка без товарів буде відхилена. Дані беруться з кошика: \Bitrix\Sale\Order::loadByAccountNumber($orderNumber)->getBasket().
postLink — URL, на який Тінькофф відправляє POST-сповіщення при зміні статусу заявки. Він має бути доступний ззовні (не localhost, не за basic auth).
Обробка callback-сповіщень
Тінькофф відправляє POST на postLink при кожній зміні статусу заявки:
| Статус | Значення | Дія в Бітрікс |
|---|---|---|
new |
Заявка створена | Нічого |
inprocess |
На розгляді | Нічого |
approved |
Схвалено | Нічого (клієнт ще не підписав) |
signed |
Договір підписано | Підтвердити оплату: $payment->setPaid('Y') |
rejected |
Відхилено | Скасувати платіж, повідомити менеджера |
canceled |
Скасовано клієнтом | Скасувати платіж |
Критично: оплату підтверджуємо тільки на статус signed, а не approved. Схвалена заявка ще може бути скасована клієнтом.
Перевірка підпису сповіщення — обов'язкова. Тінькофф передає підпис у заголовку, яка обчислюється як HMAC від тіла запиту та вашого API-ключа. Без перевірки підпису зловмисник може підтвердити оплату, відправивши фальшивий POST.
Кнопка на сторінці товару
Окрім оплати в чекауті, Тінькофф надає віджет для картки товару — показує приблизний щомісячний платіж. JS-віджет підключається скриптом:
<script src="https://forma.tinkoff.ru/static/onlineScript.js"></script> І викликається з параметрами: tinkoff.online({shopId, showcaseId, items, sum}). Інтеграція віджета в шаблон компонента bitrix:catalog.element — у файлі template.php або через result_modifier.php.
Тестування
Тінькофф надає тестове середовище з окремими shopId та showcaseId. У тестовому режимі заявки схвалюються автоматично. Обов'язково перевірте повний цикл: створення заявки → редирект → callback з кожним статусом → оновлення платежу в Бітрікс. Особливу увагу — обробці rejected та canceled: переконайтеся, що замовлення не зависає в статусі «Очікує оплати» навічно.
Що входить в роботу
- Партнерський договір (допомагаємо з заповненням)
- Налаштування обробника платіжної системи (готовий або кастомний)
- Конфігурація postLink та перевірка доступності
- Інтеграція віджета на сторінці товару
- Повне тестування всіх статусів на тестовому середовищі
- Документація з експлуатації
- Навчання менеджерів роботі з заявками
- Гарантія працездатності 30 днів
Типові помилки
- postLink недоступний ззовні — використовуйте публічний URL або перевірте налаштування брандмауера.
- Перевірка підпису не реалізована — залишає лазівку для зловмисників.
- Не передаються товарні позиції — заявка відхиляється Тінькофф.
- Оплата підтверджується на статус approved — клієнт може скасувати заявку, але гроші вже списані.
Зв'яжіться з нами для консультації та отримайте комерційну пропозицію. Замовте інтеграцію — наші інженери проведуть аудит вашого проекту за 1 день.