Интеграция 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 — официальная документация (англ.).