Інтеграція 1С-Бітрікс з платіжною системою Сбербанк Онлайн

Інтеграція 1С-Бітрікс з платіжною системою Сбербанк Онлайн

Ми часто стикаємося з такою ситуацією: інтернет-магазин на Бітрікс працює, замовлення йдуть, але покупці телефонують і просять «виставити рахунок через Сбер» — тому що не бачать потрібної кнопки на сторінці оплати. Підключення Сбербанк Онлайн до Бітрікс закриває цей запит і попутно розкриває кілька технічних нюансів, які на етапі «просто встановимо модуль» не очевидні. У нашій практиці кожен третій клієнт приходить з цим болем — відсутністю платіжного методу, який використовують 60% покупців. Ми провели понад 50 інтеграцій платіжних систем — це в 2 рази більше, ніж у середньому на ринку, тому розберемо всі підводні камені.

Чому готовий модуль не завжди вирішує проблему?

Офіційний модуль sberbank.ecom закриває 80% типових сценаріїв, але коли потрібна нестандартна логіка — наприклад, інтеграція з 1С для автоматичної зміни статусів або двостадійна оплата для попередніх замовлень — готове рішення стає вузьким місцем. Порівняємо: готовий модуль встановлюється за 30 хвилин, але кастомний обробник у 10 разів гнучкіший і дає повний контроль над обробкою платежів. Співвідношення швидкості та гнучкості — приблизно 10:1.

Як працює платіжний шлюз Сбербанку

Сбербанк Онлайн працює через REST API еквайрингу (securepayments.sberbank.ru/payment/rest/ для бойового середовища, 3dsec.sberbank.ru/payment/rest/ для тестового). Схема взаємодії:

1. Магазин викликає register.do — реєструє замовлення в системі Сбербанку, отримує orderId та formUrl
2. Покупця редиректять на formUrl — сторінку оплати Сбербанку
3. Після оплати Сбербанк перенаправляє покупця на returnUrl і відправляє нотифікацію на failUrl або виконує callback
4. Магазин викликає getOrderStatus.do для фінальної перевірки статусу

Критично важливо не покладатися тільки на returnUrl для підтвердження оплати — покупець може закрити вкладку після оплати, не дочекавшись редиректу. Завжди потрібен callback або періодичний опит getOrderStatus.do. Джерело: документація Сбербанк Еквайринг

Коли потрібна кастомна інтеграція?

В екосистемі Бітрікс Сбербанк Онлайн реалізується як обробник платіжної системи модуля sale. Є два шляхи.

Готовий модуль з Маркетплейсу. Офіційний модуль від Сбербанку (sberbank.ecom) доступний на marketplace.1c-bitrix.ru. Після встановлення в розділі Магазин → Налаштування → Платіжні системи з'являється новий тип з полями userName, password (або token для нової схеми аутентифікації). Модуль реєструє обробник \Sale\Handlers\PaySystem\SberbankHandler і webhook-URL виду /bitrix/tools/sale_ps_result.php.

Кастомний обробник потрібен, коли: використовується нестандартна схема замовлень, потрібна інтеграція з 1С для автоматичної зміни статусів, або готовий модуль конфліктує з іншими компонентами. Розміщується в /local/php_interface/include/sale_payment/sberbank_custom/, структура стандартна для Sale PaySystem.

Ключові параметри при реєстрації замовлення

Виклик register.do потребує обов'язкових параметрів:

Для роботи фіскалізації (54-ФЗ) в запит додається об'єкт orderBundle з товарними позиціями, ставками ПДВ і ознаками предмета розрахунку. Без orderBundle каса Сбербанку не сформує чек — це часта причина претензій від податкової до магазинів, які «начебто підключили онлайн-касу». Наш досвід показує, що 95% проблем з фіскалізацією вирішуються правильним orderBundle. Докладніше про вимоги — у Wikipedia.

Обробка сповіщень і статуси

Сбербанк відправляє POST-сповіщення на checkUrl при зміні статусу транзакції. В Бітрікс обробник callback повинен:

1. Прийняти POST, розпарсити mdOrder та orderNumber
2. Викликати getOrderStatus.do для отримання актуального статусу (не довіряти даним з callback без верифікації)
3. При статусі 2 (оплачено) викликати $payment->setPaid('Y') і зберегти транзакцію
4. Повернути відповідь {"errorCode": 0} — інакше Сбербанк буде повторювати спроби

Таблиця статусів getOrderStatus.do:

Двостадійна оплата

Для товарів з відкладеною відвантаженням (передзамовлення, склад) використовується двостадійна схема: registerPreAuth.do блокує суму на карті, deposit.do — списує по факту відвантаження. Сбербанк надає обидва методи, але двостадійка потребує окремого підключення в договорі еквайрингу. В Бітрікс це реалізується через розділення обробника на два етапи та додаткову кнопку «Підтвердити оплату» в адміністративній частині замовлення. Докладніше про реалізацію — в документації Бітрікс.

Як уникнути дублювання платежів?

З нашої практики: інтернет-магазин електроніки на сучасній версії Бітрікс. Після переходу з тестового середовища на бойове близько 3% транзакцій дублювалися — покупець платив один раз, в замовленні фіксувалися два платежі. Причина: обробник returnUrl та callback приходили майже одночасно, обидва встигали викликати setPaid('Y'). Рішення — додати перевірку $payment->isPaid() перед підтвердженням і використовувати блокування через \Bitrix\Main\Application::getConnection()->lock() на час обробки транзакції. Це знизило дублювання до 0%.

Тестування

Тестове середовище Сбербанку (3dsec.sberbank.ru) працює з тестовими картами з документації. Обов'язково перевірте:

• Успішну оплату з підтвердженням через callback
• Скасування на сторінці оплати (покупець натиснув «Назад»)
• Таймаут сесії (за замовчуванням 1200 секунд — Сбербанк скасовує незавершені замовлення)
• Коректність формування чека при включеній касі

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

• Аудит поточної конфігурації Бітрікс та платіжних методів
• Налаштування готового модуля або розробка кастомного обробника
• Інтеграція з фіскалізацією (54-ФЗ) та касою
• Тестування всіх сценаріїв: успіх, відмова, таймаут, дублювання
• Документація по налаштуваннях та контакти техпідтримки Сбербанку

Терміни та вартість

Терміни інтеграції залежать від конфігурації: встановлення готового модуля без каси — від 1 до 2 днів. Повна інтеграція з 54-ФЗ, двостадійною оплатою та підстроюванням під нестандартну структуру замовлень — від 3 до 7 робочих днів. Вартість від 8000 грн за готовий модуль і від 25000 грн за кастомне рішення. Економія до 30% при замовленні пакету послуг. Ми працюємо з Бітрікс понад 5 років, реалізували 50+ інтеграцій платіжних систем — це дозволяє гарантувати якість.

Замовте інтеграцію під ключ — пишіть нам для безкоштовної консультації. Ми оцінимо ваш проект і запропонуємо оптимальне рішення. Отримайте безкоштовний аудит вашої системи при зверненні до кінця місяця.