B2B-оплата за рахунком у Бітрікс: повний цикл автоматизації

Як вибудувати повний цикл B2B-оплати в 1С-Бітрікс

B2B-клієнти не платять картками — їм потрібен офіційний рахунок з печаткою та реквізитами. Без автоматизації менеджеру доводиться вручну виставляти рахунок, чекати підтвердження з бухгалтерії та відмічати оплату. Це займає години, а помилки ведуть до затримок. В 1С-Бітрікс можна налаштувати повний цикл: від збору реквізитів покупця до автоматичного підтвердження надходження на розрахунковий рахунок. Наш досвід — понад 7 років розробки, десятки проєктів з B2B-оплатою. Використовуємо перевірені патерни — користувацькі властивості замовлення, REST API банків, генерацію PDF через FPDF. Результат: час обробки платежу скорочується з двох днів до 20 хвилин, операційні витрати падають на 70%. Безготівковий розрахунок — стандартний спосіб B2B-платежів. У Бітрікс він реалізований вбудованою платіжною системою Cash/BankTransfer, згідно з офіційною документацією.

Стандартна схема B2B-оплати

1. Покупець-юрособа оформлює замовлення та обирає «Оплата за рахунком».
2. Система генерує рахунок на оплату з реквізитами продавця.
3. Бухгалтер покупця робить платіжне доручення в банку.
4. Гроші надходять на розрахунковий рахунок продавця.
5. Менеджер або банківська інтеграція фіксує оплату в Бітрікс.

Як налаштувати платіжну систему «Безготівковий розрахунок» у Бітрікс?

У Бітрікс є штатний обробник Cash / BankTransfer. Налаштовується в Магазин → Налаштування → Платіжні системи. Вкажіть реквізити компанії: назву, ІПН, КПП, розрахунковий рахунок, БІК, банк. Додайте інструкцію для покупця — текст, який побачить клієнт після вибору способу оплати.

// Параметри безготівкової оплати (вводяться в адміністративній частині)
// Логотип, назва, текст-інструкція для покупця

// У шаблоні платіжної системи — показуємо реквізити
<div class="bank-details">
    <p>Банк: ПАТ «Сбербанк»</p>
    <p>БІК: 044525225</p>
    <p>Р/р: 40702810ХХХХХХХХХХ</p>
    <p>К/р: 30101810400000000225</p>
    <p>ІПН: ХXXXXXXXXX</p>
    <p>КПП: XXXXXXXXX</p>
    <p>Призначення платежу: Оплата за рахунком №<?= $order->getAccountNumber() ?></p>
</div>

// Додавання властивостей замовлення через API Бітрікс
// local/php_interface/init.php або встановлювальний скрипт

use Bitrix\Sale\Internals\OrderPropsTable;

$props = [
    ['NAME' => 'Назва компанії', 'CODE' => 'COMPANY_NAME', 'TYPE' => 'STRING'],
    ['NAME' => 'ІПН',               'CODE' => 'INN',          'TYPE' => 'STRING'],
    ['NAME' => 'КПП',               'CODE' => 'KPP',          'TYPE' => 'STRING'],
    ['NAME' => 'Юридична адреса', 'CODE' => 'LEGAL_ADDRESS','TYPE' => 'STRING'],
    ['NAME' => 'Розрахунковий рахунок',    'CODE' => 'BANK_ACCOUNT', 'TYPE' => 'STRING'],
    ['NAME' => 'Назва банку','CODE' => 'BANK_NAME',    'TYPE' => 'STRING'],
    ['NAME' => 'БІК',               'CODE' => 'BANK_BIK',    'TYPE' => 'STRING'],
];

Чому автоматичне підтвердження оплати критичне?

Ручна відмітка про оплату — джерело затримок. Бухгалтер може забути, менеджер — помилитися. Автоматизація вирішує проблему: платіж надійшов — замовлення одразу переходить в оплачений статус. Варіанти:

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

// Приклад: парсинг виписки Сбербанку (SimpleBankStatementParser)
$statement = parseBankStatement($statementXml);

foreach ($statement->getTransactions() as $transaction) {
    if ($transaction->getType() !== 'credit') continue;

    // Шукаємо номер замовлення в призначенні платежу
    preg_match('/№(\w+-\d+)/', $transaction->getPurpose(), $matches);
    if (!isset($matches[1])) continue;

    $orderNumber = $matches[1];
    $order = getOrderByAccountNumber($orderNumber);

    if ($order && abs($order->getPrice() - $transaction->getAmount()) < 0.01) {
        setOrderPaid($order->getId(), $transaction->getDate());
    }
}

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

Як генерувати PDF-рахунок для юросіб?

Після оформлення замовлення юрособі потрібен офіційний рахунок у PDF. Бітрікс не вміє генерувати PDF «з коробки» — підключаємо сторонні бібліотеки. Використовуємо FPDF або mPDF:

// Генерація рахунку через FPDF або mPDF
function generateInvoicePdf(Bitrix\Sale\Order $order): string
{
    $pdf = new FPDF();
    $pdf->AddPage();
    $pdf->SetFont('Arial', 'B', 14);
    $pdf->Cell(0, 10, 'РАХУНОК НА ОПЛАТУ №' . $order->getAccountNumber(), 0, 1, 'C');

    // Реквізити продавця
    // Таблиця товарів
    // Разом і підписи

    $path = '/tmp/invoice_' . $order->getId() . '.pdf';
    $pdf->Output('F', $path);
    return $path;
}

Рахунок формується в момент оформлення замовлення та надсилається покупцю на email. Додатково зберігаємо у файлову систему для повторного завантаження з особистого кабінету.

Порівняння ручної та автоматичної обробки платежів

Автоматизація обробляє платежі в 10 разів швидше за ручну відмітку.

Процес налаштування під ключ

1. Аналітика — розбираємо схему роботи, визначаємо точки інтеграції.
2. Проєктування — архітектура платіжного модуля, вибір інструментів (HL-блоки для реквізитів, агенти для обробки).
3. Реалізація — налаштування платіжної системи, збір реквізитів, генерація PDF, інтеграція з API банку або 1С.
4. Тестування — перевірка всіх сценаріїв: успішна оплата, помилки, повернення, часткова оплата.
5. Деплой — викатка на продакшен, навчання менеджерів.

Терміни

Загальний термін — від 4 до 10 днів, залежно від складності та необхідності інтеграції.

Як ми гарантуємо результат

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

Як уникнути типових помилок при підключенні платіжних систем на 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С-Бітрікс. Гарантуємо працездатність кожного сценарію. Для швидкої оцінки вашого проекту залиште заявку на сайті або зв'яжіться з нами — підберемо оптимальне рішення для вашого бізнесу.