Онлайн-оплата — не просто удобство, а необходимость для e-commerce в Узбекистане. По данным ЦБ РУз, объём безналичных платежей вырос на 45% за последний год. Если ваш сайт не принимает оплату через Payme и Click, вы теряете значительную часть потенциальных клиентов.
В этой статье мы разберём весь процесс интеграции — от регистрации мерчанта до тестирования боевых транзакций.
Почему именно Payme и Click
В Узбекистане работают несколько платёжных систем, но две из них занимают более 80% рынка:
- Payme — крупнейшая платёжная система страны. Более 15 миллионов пользователей. Поддерживает карты Uzcard и Humo.
- Click — вторая по популярности система. Около 10 миллионов пользователей. Также работает с Uzcard и Humo.
Подключив обе системы, вы покрываете практически 100% аудитории, которая платит онлайн. Дополнительно стоит рассмотреть Uzum Pay (бывший Apelsin) — он активно растёт и привлекает молодую аудиторию.
Шаг 1: Подготовка документов
Перед технической интеграцией необходимо зарегистрироваться как мерчант. Для обеих систем понадобятся:
- Свидетельство о государственной регистрации юридического лица (или ИП).
- ИНН (СТИР).
- Реквизиты расчётного счёта в банке.
- Контактные данные ответственного лица.
- URL сайта, на котором будет приём платежей.
Важно: сайт должен быть уже запущен и доступен по HTTPS. Обе системы проверяют наличие SSL-сертификата, политики конфиденциальности и публичной оферты.
Регистрация в Payme
- Зайдите на merchant.payme.uz и создайте аккаунт мерчанта.
- Заполните данные компании и загрузите документы.
- Дождитесь верификации (обычно 1-3 рабочих дня).
- После одобрения вы получите Merchant ID и Secret Key для тестового и боевого окружения.
Регистрация в Click
- Перейдите на my.click.uz и зарегистрируйтесь как мерчант.
- Заполните анкету и приложите сканы документов.
- После проверки (2-5 рабочих дней) получите Service ID, Merchant ID и Secret Key.
Шаг 2: Техническая интеграция
Обе системы предлагают несколько способов интеграции. Выбор зависит от вашей платформы и требований.
Вариант 1: Checkout-форма (рекомендуем для старта)
Самый простой способ — перенаправление пользователя на страницу оплаты Payme/Click. Вам не нужно хранить карточные данные на своём сервере.
- Payme: формируете URL с параметрами (сумма, ID заказа, описание) и перенаправляете покупателя.
- Click: аналогично — формируете ссылку с параметрами оплаты.
После оплаты система отправляет callback (webhook) на ваш сервер с информацией о транзакции.
Вариант 2: API-интеграция (для продвинутых)
Полноценная интеграция через API позволяет принимать оплату прямо на вашем сайте, без перенаправления. Это лучший UX, но требует:
- PCI DSS-совместимого сервера (если обрабатываете карточные данные).
- Реализации серверных endpoint-ов для обработки запросов от платёжной системы.
- Обработки всех статусов транзакций (создана, ожидает, подтверждена, отменена, ошибка).
Вариант 3: Готовые модули для CMS
Если ваш сайт работает на 1С-Битрикс, вам повезло — для обеих систем есть готовые модули:
- Модуль устанавливается из Маркетплейса Битрикс.
- В настройках указываете Merchant ID и Secret Key.
- Модуль автоматически создаёт страницы оплаты и обрабатывает callbacks.
- Интеграция с заказами и CRM — из коробки.
Для WordPress (WooCommerce) официальных модулей нет — придётся использовать сторонние плагины или писать интеграцию самостоятельно.
Шаг 3: Тестирование
Обе системы предоставляют тестовое окружение (sandbox). Никогда не пропускайте этот этап.
Что тестировать
- Успешная оплата. Убедитесь, что после оплаты заказ меняет статус, покупатель видит подтверждение, а вы получаете уведомление.
- Отмена оплаты. Пользователь нажал «отмена» на странице платёжной системы — он должен вернуться на сайт с понятным сообщением.
- Ошибка оплаты. Недостаточно средств, превышен лимит, технический сбой — каждый сценарий должен обрабатываться корректно.
- Повторная оплата. Что произойдёт, если пользователь оплатит дважды? Система должна блокировать дублирование.
- Возврат средств. Проверьте процесс полного и частичного возврата.
Тестовые карты
Обе системы предоставляют тестовые номера карт для sandbox-окружения. Не используйте реальные карты для тестов — это нарушение правил.
Шаг 4: Запуск в продакшен
После успешного тестирования:
- Замените тестовые ключи на боевые (production).
- Убедитесь, что webhook-URL указывает на продакшен-сервер.
- Проведите одну реальную транзакцию на минимальную сумму.
- Проверьте, что деньги поступили на расчётный счёт.
- Настройте мониторинг — вы должны сразу узнавать о сбоях.
Типичные ошибки
За годы работы с интеграцией платёжных систем мы в BIT-BOX собрали список самых частых проблем:
- Несовпадение сумм. Сумма в запросе (тийинах) не совпадает с суммой заказа. Помните: Payme принимает суммы в тийинах (1 сум = 100 тийинов).
- Игнорирование callback-ов. Не полагайтесь только на redirect пользователя — он может закрыть браузер. Callback (webhook) — единственный надёжный способ подтвердить оплату.
- Нет проверки подписи. Каждый callback от Payme/Click содержит цифровую подпись. Если вы её не проверяете, злоумышленник может подделать уведомление об оплате.
- Нет обработки таймаутов. Пользователь начал оплату, но не завершил. Заказ завис в статусе «ожидает оплату» навсегда. Нужен механизм автоотмены через 30-60 минут.
- Хранение ключей в коде. Secret Key не должен быть в git-репозитории. Используйте переменные окружения или конфигурационные файлы за пределами webroot.
Комиссии
Обе системы берут комиссию с мерчанта за каждую транзакцию:
- Payme: от 1% до 2.5% в зависимости от оборота и категории бизнеса.
- Click: от 1% до 2% — условия обсуждаются индивидуально.
Комиссия снимается автоматически — на расчётный счёт приходит сумма за вычетом комиссии. Подробные условия уточняйте при регистрации мерчанта.
Как BIT-BOX помогает с интеграцией
Мы подключаем платёжные системы в рамках разработки интернет-магазинов на 1С-Битрикс. Наш стандартный процесс:
- Помогаем с регистрацией мерчанта и подготовкой документов.
- Устанавливаем и настраиваем модули Payme + Click + Uzum Pay.
- Тестируем все сценарии оплаты в sandbox.
- Запускаем в продакшен и проверяем реальные транзакции.
- Настраиваем интеграцию платежей с CRM и 1С — каждая оплата автоматически отражается в бухгалтерии.
Если у вас уже есть сайт и нужно только подключить оплату — мы тоже поможем. Это одна из самых частых задач, которую нам заказывают отдельно.
Нужно подключить онлайн-оплату?
Интегрируем Payme, Click и Uzum Pay на ваш сайт. От регистрации мерчанта до первой реальной транзакции.
Обсудить проект