Интеграция 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 день.