Послуги з підключення платіжних систем на 1С-Бітрікс

Платіжні системи для 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+)
• Часткові повернення через метод Cancel API — без дзвінків у банк

Ощадбанк (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 — інакше відмова у ревʼю
• Фолбек на стандартну форму оплати, якщо пристрій не підтримує безконтактну оплату

Розстрочка та 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 для розбору інцидентів
• Моніторинг аномалій: стрибок транзакцій, нетипова географія — алерт

Наш підхід

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

Терміни