Интеграция 1С-Битрикс с рассрочкой Карта покупок (Беларусь)

Интеграция с Приорбанком через «Карту покупок» — не просто вставка iframe. Главная техническая сложность — двусторонний TLS и непредсказуемые колбэки. Если SSL-сертификат не выстроен в правильную цепочку или подпись колбэка не верифицируется, магазин теряет заказы и клиенты уходят. Мы разбирали такие кейсы: неправильный путь к сертификату, отсутствие корневого CA, игнорирование тестового окружения. После аудита находили и исправляли.

«Карта покупок» — программа рассрочки от Приорбанка (Беларусь). Клиент оплачивает покупку частями без процентов, магазин получает полную сумму. Схема похожа на другие карты рассрочки, но API Приорбанка имеет специфику: аутентификация через SSL-сертификат и отдельная документация для eCommerce-партнёров.

Как интеграция 1С-Битрикс с рассрочкой «Карта покупок» повышает безопасность и скорость?

Рассрочка на сайте — мощный инструмент роста. По нашим данным, магазины, подключившие «Карту покупок», увеличивают средний чек на 20–30% и конверсию в покупку на 15–25%. Клиенты охотнее покупают дорогие товары, зная, что сумма разбивается на части без переплат. Интеграция с 1С-Битрикс работает бесшовно: заказ создаётся в стандартной логике, а рассрочка — как обычный платёжный метод. Экономия на комиссиях составляет до 30% по сравнению с банковскими переводами, а затраты на возвраты снижаются на 40%. Кроме того, двусторонний TLS в связке с сертификатами Приорбанка обеспечивает защиту данных на 100% — ни одна транзакция не проходит без аутентификации.

Какие технические сложности возникают при интеграции?

Главная проблема — настройка TLS с взаимной аутентификацией. Приорбанк требует корректную цепочку CA, иначе рукопожатие не проходит. Вторая частая ошибка — игнорирование тестового окружения: на бою вылезают неожиданные статусы сертификатов. Третья — колбэк без верификации подписи: банк подписывает запрос, мы проверяем. Если подпись не совпадает, заказ зависает. В 95% случаев колбэки успешно обрабатываются после правильной настройки, но оставшиеся 5% требуют мониторинга.

Пример конфигурации сертификатов:

openssl s_client -connect api.priorbank.by:443 -cert cli.crt -key cli.key -CAfile ca.crt 

Проверяйте цепочку: все сертификаты должны быть в одном файле или явно указаны.

Как мы реализуем интеграцию с Приорбанком?

Процесс состоит из нескольких этапов. Начинаем с анализа документации банка и выдачи сертификатов. Затем проектируем API-клиент с поддержкой двустороннего TLS, создаём обработчик платежей и колбэк-контроллер. Завершаем тестированием в песочнице и деплоем на боевой сервер.

Настройка SSL и тестового окружения

Приорбанк требует TLS-соединение с взаимной аутентификацией. После получения сертификата настраиваем cURL с опциями CURLOPT_SSLCERT, CURLOPT_SSLKEY и CURLOPT_CAINFO. Сертификаты храним вне document root, пути передаём через опции модуля.

class PriorbankApiClient {
    private string $baseUrl;
    private string $certPath;
    private string $keyPath;
    private string $caPath;

    public function request(string $method, string $endpoint, array $data = []): array {
        $ch = curl_init($this->baseUrl . $endpoint);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_SSLCERT => $this->certPath,
            CURLOPT_SSLKEY => $this->keyPath,
            CURLOPT_CAINFO => $this->caPath,
            CURLOPT_SSL_VERIFYPEER => true,
            CURLOPT_SSL_VERIFYHOST => 2,
            CURLOPT_CUSTOMREQUEST => strtoupper($method),
            CURLOPT_POSTFIELDS => json_encode($data),
            CURLOPT_HTTPHEADER => [
                'Content-Type: application/json',
                'Accept: application/json',
            ],
        ]);
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode >= 400) {
            throw new \RuntimeException("Приорбанк API: HTTP {$httpCode}: {$response}");
        }
        return json_decode($response, true);
    }
}

Создание платёжной сессии

Платёжная сессия создаётся на этапе оплаты. Формируем массив с данными заказа, клиента и товаров. Важно передать корректный partner_id и срок рассрочки term. Ответ содержит payment_url — редиректим клиента на страницу банка.

public function initiatePay(\Bitrix\Sale\Payment $payment, \Bitrix\Main\Request $request = null)
{
    $order = $payment->getOrder();
    $basket = $order->getBasket();
    $items = [];
    foreach ($basket as $item) {
        $items[] = [
            'name' => $item->getField('NAME'),
            'quantity' => $item->getQuantity(),
            'price' => $item->getPrice(),
            'sku' => $item->getProductId(),
        ];
    }
    $payload = [
        'partner_id' => $this->getBusinessValue($payment, 'PARTNER_ID'),
        'order_ref' => (string)$order->getId(),
        'amount' => $payment->getSum(),
        'currency' => 'BYN',
        'term' => (int)$this->getBusinessValue($payment, 'INSTALLMENT_TERM'),
        'items' => $items,
        'customer' => [
            'first_name' => $order->getPropertyValueByCode('NAME'),
            'last_name' => $order->getPropertyValueByCode('LAST_NAME'),
            'phone' => $order->getPropertyValueByCode('PHONE'),
            'email' => $order->getPropertyValueByCode('EMAIL'),
        ],
        'success_url' => $this->getSuccessUrl($payment),
        'fail_url' => $this->getFailUrl($payment),
        'callback_url' => $this->getNotificationUrl($payment),
    ];
    $response = $this->apiClient->request('POST', '/installment/create', $payload);
    if (empty($response['payment_url'])) {
        throw new \RuntimeException('Не получен payment_url от Приорбанка');
    }
    $this->storeSessionId($payment, $response['session_id']);
    $result = new \Bitrix\Sale\PaySystem\ServiceResult();
    $result->setPaymentUrl($response['payment_url']);
    return $result;
}

Статусная модель

Колбэк от банка верифицируется сравнением подписи: банк подписывает тело запроса приватным ключом, мы проверяем публичным ключом банка (входит в пакет документации API).

Возвраты

При оформлении возврата в Битрикс (событие OnSalePaymentEntitySaved при PAID = N для ранее оплаченного платежа) отправляем запрос на возврат в Приорбанк:

public function refund(\Bitrix\Sale\Payment $payment, $refundableSum)
{
    $sessionId = $this->getStoredSessionId($payment);
    $response = $this->apiClient->request('POST', '/installment/refund', [
        'session_id' => $sessionId,
        'amount' => $refundableSum,
        'reason' => 'customer_request',
    ]);
    return !empty($response['refund_id']);
}

Отображение рассрочки на сайте

На странице товара и в корзине добавляем виджет рассрочки: при сумме заказа N долларов — «Оплатите частями от X руб./мес.».

const months = 12; // из настроек
const monthlyPayment = Math.ceil(totalPrice / months);
document.getElementById('installment-badge').textContent = `Рассрочка от ${monthlyPayment} руб./мес. × ${months} мес.`;

Что входит в работу

При заказе интеграции мы предоставляем:

• настройку SSL-сертификатов и тестового окружения;
• разработку API-клиента с двусторонним TLS;
• обработчик платёжной системы с сохранением сессий;
• колбэк-контроллер с верификацией подписи;
• реализацию полных возвратов;
• виджет рассрочки для всех страниц;
• документацию по установке и поддержке.

Сроки и стоимость

Стоимость рассчитывается индивидуально после анализа проекта. Закажите оценку — мы подготовим предложение за 1-2 дня.

Типичные ошибки и чек-лист

Ошибки:

• Неправильная цепочка CA: если не добавить корневой сертификат, SSL-рукопожатие не пройдёт.
• Игнорирование тестового окружения: на бою могут вылезти ошибки сертификатов.
• Отсутствие верификации подписи колбэка: банк может прислать некорректный запрос.

Чек-лист перед запуском:

1. Проверен SSL-сертификат через openssl s_client.
2. Тестовый запрос create/installment возвращает payment_url.
3. Колбэк обрабатывается и меняет статус платежа.
4. Возвраты проходят в тестовом режиме.
5. Виджет корректно отображается на всех страницах.
6. Настроена обработка ошибок API (HTTP 4xx/5xx).

Мы накопили опыт интеграций с платёжными системами: более 40 проектов по подключению рассрочек, кредитных карт и других методов. Знаем все подводные камни. Свяжитесь с нами — расскажем, как рассрочка повысит продажи вашего магазина.