Інтеграція 1С-Бітрікс з Тінькофф Кредит

Інтеграція 1С-Бітрікс з Тінькофф Кредит

Покупець додав товар за 80 000 рублів у кошик, але не готовий платити одразу. Якщо на сторінці оформлення замовлення є кнопка «Купити в кредит», конверсія на дорогих товарах зростає на 15–25%. При середньому чеку від 30 000 рублів така інтеграція окупається за 2-3 місяці. Тінькофф Кредит — частий вибір інтернет-магазинів в Україні. Інтеграція з 1С-Бітрікс технічно нескладна, але містить нюанси, критичні для працездатності.

Ми реалізуємо таку інтеграцію під ключ за 3–7 днів, включаючи налаштування віджета на сторінці товару та повне тестування всіх сценаріїв. Наш досвід — понад 20 успішних проектів з інтеграції платіжних систем. Готові модулі економлять час, але кастомний обробник дає повний контроль над логікою та сумісністю з іншими платіжними системами — різниця в трудозатратах 3–5 разів.

Чому кастомний обробник кращий за готовий модуль?

Готові модулі з Маркетплейсу встановлюються за годину, але їхні можливості обмежені. Кастомний обробник, написаний з нуля, не тільки налаштовується під будь-які бізнес-процеси, але й легко тестується. При середній вартості інтеграції від 60 000 до 150 000 рублів різниця в гнучкості того варта. Наприклад, ви можете додати власну логіку знижок або перевірки кредитної історії.

Коли підключати віджет на сторінці товару?

Віджет Тінькофф показує приблизний щомісячний платіж прямо в картці товару. Це підвищує конверсію на 10–20% для позицій дорожче 20 000 рублів. Ми рекомендуємо підключати його для всіх товарів з високою маржинальністю.

Як працює Тінькофф Кредит

Процес з боку покупця:

1. Обирає товар → натискає «Купити в кредит»
2. Перенаправляється на форму Тінькофф, заповнює заявку
3. Тінькофф приймає рішення (1–15 хвилин)
4. При схваленні — гроші перераховуються магазину, покупець отримує товар

З боку магазину це платіжна система з відкладеним підтвердженням. Тінькофф надає API, через який магазин створює заявку на кредит, передає дані про товари та суму, отримує посилання для редиректу покупця.

Підключення: договір та налаштування

Перед технічною інтеграцією потрібен партнерський договір з Тінькофф. Після підписання ви отримуєте:

• shopId — ідентифікатор магазину
• showcaseId — ідентифікатор вітрини (можливо декілька для різних типів кредиту/розстрочки)
• API-ключ — для авторизації запитів
• Доступ в особистий кабінет партнера — для моніторингу заявок

Технічна інтеграція

У 1С-Бітрікс Тінькофф Кредит підключається як платіжна система модуля sale. Є два шляхи.

Шлях 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 при кожній зміні статусу заявки:

Критично: оплату підтверджуємо тільки на статус 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 день.

Як уникнути типових помилок при підключенні платіжних систем на 1С-Бітрікс

Найчастіша помилка при інтеграції — забути про callback. Покупець оплатив замовлення, гроші списалися, а статус у b_sale_order не оновився: менеджер бачить «Очікування оплати» і починає дзвонити клієнту. Причина — неправильний URL у налаштуваннях шлюзу або обробник, що падає з 500 при нестандартній структурі відповіді. Ми пропонуємо послуги з підключення платіжних систем на 1С-Бітрікс з повним тестуванням усіх сценаріїв: успішна оплата, відмова, тайм-аут, часткове повернення, повторний callback.

Чому callback-сповіщення критичні?

Кожен платіжний шлюз надсилає сповіщення на ваш сервер. Якщо обробник не гарантує ідемпотентність — подвійний виклик призведе до подвійного списання. Ми завжди реалізуємо перевірку за ID сповіщення (external_id) та блокування повторної обробки в \Bitrix\Sale\Order. Також критично налаштувати URL callback в особистому кабінеті агрегатора — /bitrix/tools/sale_ps_result.php для штатного модуля. Якщо використовуєте кастомний обробник, перевіряємо, що він віддає HTTP 200 навіть при помилці параметрів (шлюз не повинен повторювати запит нескінченно). Через некоректний callback втрачається до 30% успішних оплат — покупець платить, але статус не оновлюється, і ви не отримуєте гроші.

use Bitrix\Sale\Order;
use Bitrix\Main\Application;

// Отримуємо дані сповіщення
$data = Application::getInstance()->getContext()->getRequest()->toArray();
// Перевіряємо підпис (залежить від агрегатора)
if (!checkSignature($data, 'SECRET_KEY')) {
    die('FAIL');
}
// Шукаємо замовлення за зовнішнім ID
$order = Order::loadByExternalId((int)$data['order_number']);
if ($order && $order->isPaid() === false) {
    $order->setField('PAYED', 'Y');
    $order->save();
}
echo 'OK';

Як вибрати платіжний агрегатор для 1С-Бітрікс?

Вибір залежить від географії покупців, середнього чека та потреби у розстрочці. Для ринку РФ базовий набір — ЮKassa (усі основні методи, фіскалізація з коробки) та CloudPayments (віджет без редиректу, Apple Pay, Google Pay). Якщо працюєте з великими корпоративними клієнтами — додайте Ощадбанк (SberPay, СБП). Для міжнародних продажів — Stripe або PayPal. Ми часто використовуємо дворівневу схему: основний агрегатор + резервний (автоперемикання при падінні). CloudPayments забезпечує на 15–25% більше успішних оплат за рахунок віджету без редиректу — покупець не йде з сайту.

Які платіжні агрегатори та способи оплати ми використовуємо

ЮKassa

Один договір — всі основні способи: картки Visa/MasterCard/МИР, ЮMoney, SberPay, інтернет-банки, розстрочка. Фіскалізація за 54-ФЗ з коробки (через модуль sale). Штатний обробник /bitrix/modules/sale/handlers/paysystem/yandexpay/ покриває базові сценарії. Для холдування (двостадійна оплата), підписок або спліт-платежів — кастомна інтеграція через API v3. Callback налаштовуємо на /bitrix/tools/sale_ps_result.php, парсимо notification та оновлюємо \Bitrix\Sale\Order через setField('PAYED', 'Y').

CloudPayments

Заточений на конверсію: віджет оплати прямо на сторінці чекауту, без редиректу на зовнішній домен. Покупець не йде з сайту — відсоток відмов на етапі оплати падає. Підтримує рекурентні платежі (токенізація картки через cryptogram), Apple Pay та Google Pay. 3D Secure з інтелектуальною маршрутизацією — запитується лише при високому ризику фроду. Інтеграція з Бітрікс — через REST API CloudPayments та кастомний обробник.

Тинькофф Оплата

API-інтеграція через TinkoffPaymentAPI (готовий модуль або ручна реалізація). QR-код для оплати через додаток, розстрочка «Тинькофф Кредит» — критично для дорогих товарів. Часткові повернення через метод Cancel — без дзвінків у банк, все з адмінки Бітрікс.

Ощадбанк (SberPay та СБП)

SberPay — оплата за push-сповіщенням або QR, СБП — комісія нижча порівняно з картками. На обсязі це відчутна економія. Холдування через API registerPreAuth / deposit. Враховуємо, що для SberPay потрібне підписання окремого договору з банком.

Apple Pay та Google Pay

Оплата в два дотики, без введення даних картки. Підключаються через агрегатор (ЮKassa, CloudPayments, Тинькофф). Важливі нюанси:

• Apple Pay вимагає верифікації домену: файл apple-developer-merchantid-domain-association в /.well-known/. Без нього кнопка не з'явиться.
• Розміщення кнопок строго за гайдлайнами Apple та Google — інакше відмова в рев'ю.
• Фолбек на стандартну форму оплати, якщо пристрій не підтримує безконтактну оплату.

Розстрочка, BNPL та робота з 54-ФЗ

Якщо середній чек великий і конверсія просідає — розстрочка знімає ціновий бар'єр. Ми підключаємо:

• Тинькофф Розстрочка (3–24 місяці)
• Покупай зі Сбером
• Мокка / Долями — BNPL: 4 платежі, 0% для покупця

Інтеграція: віджет з розрахунком щомісячного платежу на картці товару («від суми на місяць»), передача даних замовлення в банк через API, обробка статусів (схвалення, відмова, очікування документів) в обробниках OnSaleStatusOrder.

Фіскалізація за 54-ФЗ — обов'язкова вимога. Штраф за відсутність чека — до значної суми. Відповідно до Федерального закону № 54-ФЗ касовий чек повинен бути надісланий покупцю в електронній формі. Підключаємо АТОЛ Онлайн, Orange Data, Модуль.Каса, Евотер, Штрих-М. Налаштування в Бітрікс — розділ «Каси» в модулі sale:

• Ставка ПДВ, предмет та спосіб розрахунку — помилка в будь-якому полі може призвести до штрафу при перевірці.
• Чеки при передоплаті та частковій оплаті (два чеки: при оплаті та при відвантаженні).
• Чеки повернення при скасуванні через \Bitrix\Sale\Cashbox\Cashbox::addChecks().
• Моніторинг: якщо чек не пішов — алерт менеджеру.

При торгівлі взуттям, одягом, парфумерією обов'язкова передача кодів маркування в чеку. Інтеграція з «Честний ЗНАК», сканування DataMatrix при збірці замовлення, автоматичний вивід з обігу при продажу через \Bitrix\Catalog\Product\Marking.

Супровід платежів: повернення, мультивалютність, безпека

Повернення

Повне та часткове повернення без дзвінків у банк — через API агрегатора (refund / cancel). Чек повернення формується автоматично, оновлюється статус замовлення, перераховується сума, сповіщається покупець. Строки: електронні гаманці та СБП — 1–3 дні, банківська картка — до 30 робочих днів (залежить від банку-емітента).

Мультивалютність

Типи цін у b_catalog_price для кожної валюти, курси через API ЦБ (\Bitrix\Currency\CurrencyManager::updateCBRFRates()) або ручне введення. Конвертація на рівні каталогу — покупець бачить ціни у своїй валюті. Для прийому доларів/євро підключаємо Stripe, PayPal. Враховуємо комісії за конвертацію при розрахунку маржинальності.

Безпека

Дані карток обробляються на стороні сертифікованого шлюзу (PCI DSS) — номер картки ніколи не проходить через ваш сервер. Антифрод на рівні агрегатора. Логування всіх подій у b_sale_order_change для аудиту. Моніторинг аномалій: стрибок транзакцій, нетипова географія — алерт.

Як ми працюємо та які орієнтовні терміни?

1. Аналіз — які способи оплати потрібні, ринки, обсяг транзакцій, поточний агрегатор.
2. Підбір рішень — іноді два агрегатори краще одного: ЮKassa як основний, CloudPayments як резерв — при падінні одного трафік іде на другий.
3. Інтеграція — тестуємо кожен сценарій: успішна оплата, відмова 3DS, тайм-аут шлюзу, подвійний callback, часткове повернення.
4. Фіскалізація — онлайн-каса, перевірка коректності чеків на тестових замовленнях.
5. Моніторинг — алерти при збоях шлюзу, дашборд конверсії на етапі оплати.

Як підібрати оптимальний платіжний агрегатор?

Вибір агрегатора залежить від специфіки бізнесу: обсягу продажів, географії клієнтів, необхідності у розстрочці або рекурентних платежах. Ми допомагаємо проаналізувати ваші потреби та обрати найкраще рішення. Маємо понад 7 років досвіду в інтеграції платіжних систем на Бітрікс, реалізували більше 50 проектів. Замовте консультацію — ми розповімо про плюси та мінуси кожного варіанту.

Що входить в роботу

• Повне налаштування вибраних платіжних систем в 1С-Бітрікс: модулі, обробники, callback, тестування.
• Документація з інтеграції (схема роботи шлюзів, опис обробників, логи).
• Навчання вашого менеджера роботі з платіжними модулями та поверненнями.
• Технічна підтримка на етапі запуску та перші 2 тижні експлуатації.
• Моніторинг — налаштовуємо алерти на помилки та падіння конверсії.

Всі роботи виконуються сертифікованими розробниками 1С-Бітрікс. Гарантуємо працездатність кожного сценарію. Для швидкої оцінки вашого проекту залиште заявку на сайті або зв'яжіться з нами — підберемо оптимальне рішення для вашого бізнесу.