Платёжные системы для 1С-Битрикс
Callback-уведомления — ядро платёжной интеграции
Самая частая ошибка при подключении платёжки к Битрикс — забыть про callback (webhook). Покупатель оплатил заказ, деньги списались, а статус в b_sale_order не обновился: менеджер видит «Ожидание оплаты» и начинает звонить клиенту. Причина — неправильный URL в настройках платёжного шлюза или обработчик, который падает с 500 при нестандартной структуре ответа. Мы подключаем платёжные системы с полным тестированием всех сценариев: успешная оплата, отказ, таймаут, частичный возврат, повторный callback (идемпотентность).
Платёжные агрегаторы
ЮKassa
Один договор, все основные способы оплаты: карты Visa/MasterCard/МИР, ЮMoney, SberPay, интернет-банки, рассрочка. Фискализация по 54-ФЗ из коробки.
Подключение к Битрикс: штатный обработчик /bitrix/modules/sale/handlers/paysystem/yandexpay/ покрывает базовые сценарии. Для двухстадийной оплаты (холдирование → capture), подписок и сплит-платежей — кастомная интеграция через YooKassa API v3. Callback настраиваем на /bitrix/tools/sale_ps_result.php, парсим уведомление и обновляем \Bitrix\Sale\Order через setField('PAYED', 'Y').
CloudPayments
Заточен на конверсию: виджет оплаты прямо на странице чекаута, без редиректа на внешний домен. Покупатель не уходит с сайта — процент отказов на этапе оплаты падает.
- Рекуррентные платежи для подписок (токенизация карты через
cryptogram) - Apple Pay / Google Pay через единый виджет
- 3D Secure с интеллектуальной маршрутизацией — запрашивается только при высоком риске фрода
Интеграция с Битрикс — через REST API CloudPayments и кастомный обработчик платёжной системы в модуле sale.
Тинькофф Оплата
- API-интеграция через
TinkoffPaymentAPIили готовый модуль - QR-код для оплаты через приложение
- Рассрочка «Тинькофф Кредит» — критично для дорогих товаров (средний чек 50K+)
- Частичные возвраты через метод
CancelAPI — без звонков в банк
Сбербанк (SberPay)
- SberPay — оплата по push-уведомлению или QR
- СБП — комиссия 0.4-0.7% вместо 1.5-2.5% по картам. На объёме — ощутимая экономика
- Холдирование через API
registerPreAuth/deposit
Apple Pay и Google Pay
Оплата в два касания, без ввода данных карты. Подключение — через агрегатор (ЮKassa, CloudPayments, Тинькофф).
Нюансы, которые часто упускают:
-
Apple Pay требует верификации домена: файл
apple-developer-merchantid-domain-associationв/.well-known/. Без этого кнопка не появится - Размещение кнопок строго по гайдлайнам Apple и Google — иначе отказ в ревью
- Фоллбэк на стандартную форму оплаты, если устройство не поддерживает бесконтактную оплату
| Способ оплаты | Устройства | Браузеры |
|---|---|---|
| Apple Pay | iPhone, iPad, Mac | Safari |
| Google Pay | Android, Chrome | Chrome, Firefox, Edge |
| Samsung Pay | Samsung Galaxy | Samsung Internet |
Рассрочка и BNPL
Средний чек 30K+ и конверсия проседает — рассрочка снимает ценовой барьер:
- Тинькофф Рассрочка — 3-24 месяца
- Покупай со Сбером
- Мокка / Долями — BNPL: 4 платежа, 0% для покупателя
Интеграция: виджет расчёта на карточке товара («от 2 500₽/мес» рядом с полной ценой), передача данных заказа в банк через API, обработка статусов (одобрение, отказ, ожидание документов) в обработчиках OnSaleStatusOrder.
Онлайн-кассы и 54-ФЗ
Штраф за отсутствие чека — до 100% от суммы расчёта. Не теоретически, а практически.
Подключаем АТОЛ Онлайн, Orange Data, Модуль.Касса, Эвотор, Штрих-М. Настройка в Битрикс — через модуль sale → «Кассы»:
- Ставка НДС, предмет расчёта, способ расчёта — ошибка в любом поле = штраф при проверке
- Чеки при предоплате и частичной оплате (два чека: при оплате и при отгрузке)
- Чеки возврата при отмене через
\Bitrix\Sale\Cashbox\Cashbox::addChecks() - Мониторинг: если чек не ушёл — алерт менеджеру
Маркировка
Для обуви, одежды, парфюмерии — передача кодов маркировки в чеке обязательна. Интеграция с «Честный ЗНАК», сканирование DataMatrix при сборке заказа, автоматический вывод из оборота при продаже через \Bitrix\Catalog\Product\Marking.
Возвраты
Автоматизация через админку Битрикс:
- Полный и частичный возврат без звонков в банк — через API агрегатора (
refund/cancel) - Чек возврата по 54-ФЗ формируется автоматически
- Обновление статуса заказа, пересчёт суммы, уведомление покупателю
Сроки зависят от способа оплаты: электронный кошелёк и СБП — 1-3 дня, банковская карта — до 30 рабочих дней (зависит от банка-эмитента).
Мультивалюта
- Типы цен в
b_catalog_priceдля каждой валюты - Курсы через API ЦБ (
\Bitrix\Currency\CurrencyManager::updateCBRFRates()) или ручной ввод - Конвертация на уровне каталога — покупатель видит цены в своей валюте
- Stripe, PayPal — для приёма из-за рубежа (доллары, евро)
- Учёт комиссий за конвертацию при расчёте маржинальности
Безопасность
- PCI DSS: данные карт обрабатываются на стороне сертифицированного шлюза, не на вашем сервере. Номер карты никогда не проходит через Битрикс
- Антифрод на уровне агрегатора
- Логирование в
b_sale_order_changeдля разбора инцидентов - Мониторинг аномалий: скачок транзакций, нетипичная география — алерт
Наш подход
- Анализ — способы оплаты, рынки, объём транзакций, текущий агрегатор.
- Подбор — иногда два агрегатора лучше одного. ЮKassa как основной, CloudPayments как резерв — при падении одного трафик уходит на второй.
- Интеграция — тестируем каждый сценарий: успешная оплата, отказ 3DS, таймаут шлюза, двойной callback, частичный возврат.
- Фискализация — онлайн-касса, проверка корректности чеков на тестовых заказах.
- Мониторинг — алерты при сбоях шлюза, дашборд конверсии на этапе оплаты.
Сроки
| Задача | Ориентировочный срок |
|---|---|
| Подключение одной платёжной системы | 2-5 дней |
| Комплексная настройка платежей (несколько агрегаторов) | 1-2 недели |
| Подключение онлайн-кассы (54-ФЗ) | 3-5 дней |
| Интеграция рассрочки | 3-5 дней |
| Настройка мультивалютности | 1 неделя |
| Полная платёжная инфраструктура | 3-5 недель |







