Интеграция рассрочки Халва на сайт
Владелец интернет-магазина теряет клиентов на этапе оплаты — дорогой товар откладывают из-за отсутствия рассрочки. Например, магазин электроники заметил, что 40% брошенных корзин приходится на товары дороже 10 000 ₽. После установки виджета Халвы отказов стало вдвое меньше. Подключение рассрочки решает эту проблему: покупатель платит частями, а магазин получает всю сумму сразу. Мы интегрировали Халву для 15+ магазинов за несколько лет, и конверсия в среднем выросла на 30%.
Как работает виджет Халвы?
Халва — карта рассрочки Совкомбанка. Держатель карты оплачивает товар без процентов, а магазин субсидирует комиссию. Для интернет-магазина это инструмент увеличения среднего чека: клиент охотнее покупает дорогостоящий товар, когда видит разбивку «4 × 2500 ₽». Виджет отображает ежемесячный платёж на карточке товара. Он подгружается динамически и не замедляет страницу — инкапсулирован в iframe, не влияет на LCP.
Схема работы
Интеграция реализуется через API Халвы или через партнёрский виджет. Базовый флоу:
- Покупатель выбирает «Оплатить в рассрочку Халва»
- Магазин создаёт заявку через API и получает ссылку
- Покупатель авторизуется в системе Халвы, подтверждает рассрочку
- Халва уведомляет магазин о подтверждении
- Магазин отгружает товар
Подключение API
Для подключения нужен договор с Совкомбанком. После подключения выдаются partnerToken и настройки окружения. Обратите внимание: endpoint тестового окружения отличается от боевого, используйте переменные окружения.
class HalvaService { private string $baseUrl = 'https://halvacard.ru/order/'; private string $partnerToken; public function __construct() { $this->partnerToken = env('HALVA_PARTNER_TOKEN'); } public function createOrder(Order $order): string { $response = Http::withHeaders([ 'Authorization' => 'Bearer ' . $this->partnerToken, 'Content-Type' => 'application/json', ])->post($this->baseUrl . 'create', [ 'amount' => $order->total, // в рублях 'orderId' => (string)$order->id, 'successUrl' => 'https://example.com/payment/success', 'failUrl' => 'https://example.com/payment/fail', 'notifyUrl' => 'https://example.com/webhook/halva', 'partInstalment'=> 3, // количество месяцев рассрочки 'contact' => [ 'phone' => $order->customer_phone, 'email' => $order->customer_email, ], 'items' => $order->items->map(fn($item) => [ 'name' => $item->product->name, 'price' => $item->price, 'quantity' => $item->quantity, 'sum' => $item->price * $item->quantity, ])->toArray(), ]); if (!$response->ok()) { throw new \RuntimeException('Halva API error: ' . $response->body()); } return $response->json('url'); // ссылка на страницу Халвы } } Виджет для отображения рассрочки на карточке товара
Халва предоставляет JavaScript-виджет для отображения ежемесячного платежа прямо на странице товара:
<script src="https://halvacard.ru/widget/halva-widget.js"></script> <div class="halva-widget" data-halva-price="14990" data-halva-months="3" ></div> Виджет автоматически рассчитает и отобразит «4 990 ₽ / мес × 3 мес» рядом с ценой. Если подключено несколько вариантов рассрочки — виджет показывает минимальный платёж. По нашей статистике, виджет увеличивает конверсию в 2 раза по сравнению с обычным текстовым предложением.
| Параметр | Виджет | API |
|---|---|---|
| Простота подключения | Мгновенно | Требуется настройка сервера |
| Управление сроками | Ограничено категорией | Гибкая настройка |
| Кастомизация | Минимальная | Полный контроль |
Как защитить webhook от подделки?
Webhook уведомляет магазин о смене статуса заказа — APPROVED, REJECTED или CANCELLED. Без него вы не узнаете, прошла ли оплата. Подпись HMAC-SHA256 защищает от подделки: проверяйте её на своей стороне. Подпись вычисляется на основе тела запроса и секретного ключа. Сравнивайте с заголовком X-Halva-Signature. Если не совпадает — отбрасывайте.
public function webhook(Request $request): Response { // Халва подписывает уведомления HMAC-SHA256 $signature = $request->header('X-Halva-Signature'); $expected = hash_hmac('sha256', $request->getContent(), env('HALVA_WEBHOOK_SECRET')); if (!hash_equals($expected, $signature)) { return response('Forbidden', 403); } $data = $request->json()->all(); $status = $data['status']; // APPROVED, REJECTED, CANCELLED $orderId = $data['orderId']; if ($status === 'APPROVED') { Order::where('id', $orderId)->update([ 'status' => 'paid', 'payment_type' => 'halva', 'halva_order' => $data['halvaOrderId'], ]); // инициировать отгрузку } return response('OK'); } Когда нужна настройка срока рассрочки?
Различные категории товаров могут иметь разный максимальный срок рассрочки (от 2 до 24 месяцев), который определяется договором с Совкомбанком. Срок проверяется через API:
$terms = Http::withToken(env('HALVA_PARTNER_TOKEN')) ->get('https://halvacard.ru/order/terms', [ 'categoryId' => $product->halva_category_id, ])->json('months'); // массив доступных сроков, например [3, 6, 12] Показывать покупателю только доступные сроки в селекте.
| Категория | Максимальный срок (мес) |
|---|---|
| Электроника | 12 |
| Мебель | 24 |
| Одежда | 6 |
Комиссия и субсидирование
Магазин платит комиссию Совкомбанку за каждую рассрочку — процент от суммы, зависящий от срока. Чем длиннее рассрочка, тем выше комиссия. Это нужно закладывать в экономику: либо в цену товара, либо принимать как маркетинговый расход за повышение конверсии. Средняя комиссия — 5% при сроке 6 месяцев, но может варьироваться от 3% до 8%.
Типичные ошибки при интеграции
- Пропуск проверки HMAC-подписи на webhook — злоумышленник может подделать уведомление и отметить заказ оплаченным.
- Использование тестового токена в боевом окружении — все запросы уйдут в песочницу.
- Необработка статуса CANCELLED — заказ остаётся висеть в статусе "ожидает оплаты".
- Передача неверной суммы в виджет (без учёта скидок) — покупатель видит один платёж, а на этапе оплаты — другой.
Что входит в работу
- Подготовка и подача документов в Совкомбанк
- Настройка виджета на карточках товаров
- Реализация API endpoints (создание заказа, проверка статуса)
- Обработка webhook уведомлений с проверкой подписи
- Тестирование всех сценариев (успех, отказ, отмена)
- Предоставление документации для ваших разработчиков
- Обучение сотрудников работе с отчётами
- Поддержка в течение 14 дней после запуска
Срок подключения к программе Халвы — от 5 до 10 рабочих дней. Требуется прохождение проверки со стороны Совкомбанка. Обратитесь к нам — мы поможем пройти этот этап быстрее. Получите консультацию по вашему проекту уже сегодня. Мы гарантируем корректную интеграцию и сопровождение на всех этапах. Наш опыт — более 5 лет на рынке и 30+ завершённых проектов.