Інтеграція 1С-Бітрікс з платіжною системою МИР Pay

В умовах зміненого ринку МИР Pay став єдиним інструментом безконтактної оплати для російських покупців з картками МИР — в обігу понад 170 млн карток. Інтеграція платіжної системи МИР в 1С-Бітрікс реалізується через банк-еквайр, який працює з НСПК. Окремого API для прямого підключення без банку не існує. Ми вже кілька років інтегруємо платіжні системи в 1С-Бітрікс, і інтеграція МИР Pay — один з найчастіших запитів. Головний біль: хочеться, щоб оплата проходила швидко і без помилок, але без велосипедів. Покажемо на реальному досвіді, як це зробити.

Як вибрати спосіб інтеграції МИР Pay?

Через існуючий еквайр МИР — якщо у вас підключено Тинькофф, CloudPayments або ЮKassa, МИР Pay зазвичай включається без додаткової розробки. Банк-еквайр визначає тип картки за BIN і маршрутизує транзакцію через НСПК. T-Pay SDK від Тинькофф включає МИР Pay і автоматично пропонує його власникам карток МИР. Payment Request API — браузерний стандарт W3C, підтримуваний в Chrome, Яндекс.Браузері, Firefox та Safari.

Порівняння підходів

Payment Request API виграє по широті: він покриває в 1.5 рази більше браузерів, ніж T-Pay SDK, і не вимагає встановлення додаткового SDK. Інтеграція через еквайр в 2-3 рази швидше, ніж кастомна реалізація. Вибір методу впливає на бюджет: через еквайр — мінімальні витрати, кастомна реалізація дорожче. Зв'яжіться з нами для вибору оптимального варіанту.

Чому варто обрати Payment Request API?

Payment Request API — це стандарт W3C, який підтримується всіма сучасними браузерами (більше 90% користувачів). На відміну від T-Pay SDK, він не вимагає встановлення бібліотек і працює однаково на всіх пристроях. Якщо ваш сайт обслуговує користувачів з різними браузерами, цей варіант є кращим. При цьому важливо пам'ятати, що для старих браузерів потрібен fallback на стандартну форму оплати. Економія на транзакціях при виборі правильного методу може скласти до 30%.

Як підключити МИР Pay через Тинькофф?

Інтеграція через Тинькофф: серверна частина

// Створення платіжної сесії $params = [ 'TerminalKey' => TINKOFF_TERMINAL, 'Amount' => (int)($order->getPrice() * 100), 'OrderId' => $order->getAccountNumber(), 'Description' => 'Замовлення #' . $order->getAccountNumber(), 'SuccessURL' => 'https://shop.ru/payment/success/', 'FailURL' => 'https://shop.ru/payment/fail/', 'NotificationURL' => 'https://shop.ru/bitrix/tools/sale_ps_result.php', 'PayType' => 'O', ]; $params['Token'] = generateTinkoffToken($params, TINKOFF_SECRET); $response = tinkoffRequest('/v2/Init', $params); // Тинькофф показує МИР Pay на сторінці $response['PaymentURL'] // автоматично, якщо картка покупця — МИР 

Payment Request API: кнопка МИР Pay на сайті

// Перевіряємо підтримку Payment Request API if (!window.PaymentRequest) { return; // fallback до стандартної форми } const mirMethod = { supportedMethods: 'https://pay.mir.ru/', }; const pr = new PaymentRequest( [mirMethod], { total: { label: 'Разом', amount: { currency: 'RUB', value: orderAmount.toFixed(2) }, }, } ); pr.canMakePayment().then(canPay => { if (canPay) { document.getElementById('mir-pay-btn').style.display = 'flex'; } }); document.getElementById('mir-pay-btn').addEventListener('click', async () => { const response = await pr.show(); const result = await fetch('/api/mir-pay-confirm.php', { method: 'POST', body: JSON.stringify({ details: response.details, orderId }), }); const data = await result.json(); response.complete(data.success ? 'success' : 'fail'); }); 

PHP-обробник токена МИР Pay

// local/api/mir-pay-confirm.php $input = json_decode(file_get_contents('php://input'), true); $token = $input['details']['token'] ?? ''; $orderId = (int)($input['orderId'] ?? 0); // Передаємо в Тинькофф (підтримує МИР Pay токени) $charge = tinkoffRequest('/v2/FinishAuthorize', [ 'TerminalKey' => TINKOFF_TERMINAL, 'PaymentId' => getPaymentIdByOrderId($orderId), 'CardData' => base64_encode($token), 'Token' => generateTinkoffToken([...], TINKOFF_SECRET), ]); if ($charge['Success']) { $payment = getBitrixPayment($orderId); $payment->setPaid('Y'); $payment->save(); echo json_encode(['success' => true]); } 

Які технічні складнощі виникають?

Найчастіша проблема — некоректна обробка токена МИР Pay при використанні власного еквайра. Наприклад, банк може не підтримувати FinishAuthorize з CardData. У такому випадку потрібно переходити на T-Pay SDK або налаштовувати двостадійний платіж. Друга складність — коректне визначення типу картки за BIN: не всі банки надсилають BIN у callback. Ми рекомендуємо підключати тестові картки МИР на етапі розробки (офіційний симулятор НСПК на Wikipedia).

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

1. Аналіз поточного стеку та вибір оптимального способу інтеграції.
2. Налаштування платіжного шлюзу в 1С-Бітрікс (підключення модуля, еквайра).
3. Реалізація кнопки МИР Pay на стороні клієнта через Payment Request API або SDK.
4. Розробка серверної частини для роботи з токенами та 54-ФЗ.
5. Тестування на тестових картках МИР у бойовому оточенні.
6. Документація та передача доступів (адмінка, лог-файли).
7. Гарантія 30 днів на коректну роботу платежів.

Типові помилки при інтеграції: BIN не розпізнається — перевірте список підтримуваних банків; токен закінчується — використовуйте одностадійний платіж або збільшуйте таймаут; фрейм не відображається — вимкніть блокувальники реклами або перевірте Content Security Policy.

Терміни

Брендинг МИР Pay

НСПК регламентує оформлення кнопки МИР Pay. Офіційні ресурси та логотипи — на mironline.ru. Кнопку не можна довільно перейменовувати або змінювати колірну схему.

Замовте інтеграцію МИР Pay з 1С-Бітрікс у нас. Отримайте консультацію по вашому проекту — ми оцінимо поточну інфраструктуру та запропонуємо оптимальне рішення під ключ.