Интеграция 1С-Битрикс с платежной системой Click (Узбекистан)

Мы интегрируем 1С-Битрикс с платёжной системой Click (Узбекистан). Интернет-магазинам в Узбекистане нужен локальный платёжный метод — Click установлен у 80% активных покупателей, он работает с картами Uzcard и Humo. Без этой интеграции вы теряете до половины потенциальных заказов. У нас за плечами 5+ лет опыта и более 20 успешных проектов с Click — гарантируем стабильную работу даже при высоких нагрузках. Click SPAY — это протокол оплаты, при котором покупатель подтверждает платёж в мобильном приложении или через SMS. По сравнению с классическим процессингом, SPAY обрабатывает транзакции в 2-3 раза быстрее: среднее время подтверждения — 3 секунды против 10-15 при стандартном вводе карты. Кроме того, Click не требует ввода номера карты на сайте — вся чувствительная информация остаётся внутри приложения Click, что снижает нагрузку по PCI DSS.

Почему Click — оптимальный выбор для Узбекистана?

В Узбекистане пластиковые карты национальных платёжных систем Uzcard и Humo используются повсеместно. Click выступает как единый шлюз для приёма обеих карт, а также позволяет оплачивать через счёт в приложении. Доля онлайн-платежей через Click превышает 60% среди всех электронных транзакций в Узбекистане. Интеграция с 1С-Битрикс открывает ваш магазин для этих покупателей. Мы уже реализовали такие решения для клиентов из разных сфер — от электроники до одежды — и средний прирост конверсии составил 25%.

Как проходит интеграция Click в Битрикс?

Процесс включает четыре этапа:

1. Регистрация мерчанта в Click — получаем serviceId, merchantId, secretKey.
2. Настройка callbacks — Prepare и Complete на ваш сервер.
3. Реализация платёжной формы — генерация ссылки или создание инвойса через API.
4. Тестирование на стенде Click и боевом контуре.

Мы готовим документацию по каждому этапу, предоставляем доступ к тестовой среде и обучаем операторов. После запуска — 2 недели технической поддержки.

Что такое Prepare и Complete callbacks?

Click использует двухшаговую модель: сначала запрос на подготовку (Prepare), затем на завершение (Complete). Это позволяет магазину зарезервировать товар до фактической оплаты и избежать двойных списаний.

// Prepare callback — проверка подписи и существования заказа $clickTransId = $_POST['click_trans_id']; $merchantTransId = $_POST['merchant_trans_id']; // наш orderId $amount = $_POST['amount']; $signString = $_POST['sign_string']; $signTime = $_POST['sign_time']; $expectedSign = md5($clickTransId . $serviceId . $secretKey . $merchantTransId . $amount . $signTime); if ($signString !== $expectedSign) { echo json_encode(['error' => -1, 'error_note' => 'Invalid sign']); exit; } $order = \Bitrix\Sale\Order::loadByAccountNumber($merchantTransId); if (!$order) { echo json_encode(['error' => -5, 'error_note' => 'Order not found']); exit; } echo json_encode([ 'click_trans_id' => $clickTransId, 'merchant_trans_id' => $merchantTransId, 'merchant_prepare_id' => $orderId, 'error' => 0, 'error_note' => 'Success', ]); 

// Complete callback — финальное подтверждение и установка статуса оплаты $merchantPrepareId = $_POST['merchant_prepare_id']; $error = $_POST['error']; // 0 = успех if ($error === '0' || $error === 0) { $order = \Bitrix\Sale\Order::loadByAccountNumber($merchantPrepareId); $order->setField('PAYED', 'Y'); $order->save(); } echo json_encode([ 'click_trans_id' => $_POST['click_trans_id'], 'merchant_trans_id' => $_POST['merchant_trans_id'], 'merchant_confirm_id' => $orderId, 'error' => 0, 'error_note' => 'Success', ]); 

Типичная ошибка — неверная проверка подписи sign_string. Подпись формируется через md5 с конкатенацией полей в строгом порядке: click_trans_id + service_id + secret_key + merchant_trans_id + amount + sign_time. Пропуск любого поля или неправильный порядок приводит к ошибке -1. Также важно проверять статус заказа в Complete: если заказ уже оплачен (PAYED=Y), возвращайте ошибку -9 во избежание двойного списания.

Сравнение SPAY и прямой интеграции API

Формирование платежа через API

Для создания инвойса используем Merchant API Click:

$serviceId = $this->getBusinessValue($payment, 'CLICK_SERVICE_ID'); $merchantId = $this->getBusinessValue($payment, 'CLICK_MERCHANT_ID'); $secretKey = $this->getBusinessValue($payment, 'CLICK_SECRET_KEY'); $orderId = $payment->getOrder()->getId(); $amount = $payment->getSum(); // в UZS $timestamp = time(); $digest = md5($timestamp . $secretKey); $authHeader = $merchantId . ':' . $digest . ':' . $timestamp; $invoiceData = [ 'service_id' => $serviceId, 'amount' => $amount, 'phone_number' => $phone, 'merchant_trans_id' => $orderId, ]; $response = $this->httpPost( 'https://api.click.uz/v2/merchant/invoice/create', $invoiceData, ['Auth: ' . $authHeader, 'Content-Type: application/json'] ); // $response['invoice_id'] — ID созданного счета 

Можно также использовать прямую платёжную ссылку без API — это проще, но даёт меньше контроля.

Особенности работы с UZS и узбекскими картами

Click оперирует в узбекских сумах (UZS). Курс UZS к USD динамичен, поэтому при настройке важно указывать актуальный курс в Битрикс. В 1С-Битрикс необходимо добавить валюту UZS с правильным курсом и настроить формат отображения сумм. Карты Uzcard и Humo не имеют международных BIN-кодов, поэтому Click обрабатывает их через свою локальную процессинговую сеть — это обеспечивает мгновенное подтверждение.

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

• Документация: описание callbacks, примеры кода, инструкция по настройке валюты.
• Доступ к тестовому стенду Click для отладки.
• Обучение операторов: как обрабатывать неудачные платежи и возвраты.
• Поддержка 2 недели после запуска.

Мы — команда сертифицированных Битрикс-разработчиков с 7-летним стажем. Выполнили 50+ интеграций платёжных систем, включая Click, Payme, Uzum. Каждый проект проходит код-ревью и нагрузочное тестирование.

Сроки разработки

Оценим ваш проект за 1 час — свяжитесь, чтобы обсудить детали. Получите консультацию по интеграции Click в ваш магазин на 1С-Битрикс.

Полезные ссылки

• Click (платёжная система) — общая информация.
• Uzcard — описание локальной карты.
• Merchant API Click — официальная документация (англ.).