Интеграция 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С-Битрикс у нас. Получите консультацию по вашему проекту — мы оценим текущую инфраструктуру и предложим оптимальное решение под ключ.