ecommerce
Интеграция Click, Payme и Uzcard: пошагово для интернет-магазинов
Как подключить Click, Payme и Uzcard на сайт или Telegram-бот в Узбекистане. Договор с банком, технические требования, реальные сроки и комиссии 2026.
Материал основан на проектной практике SAMSA.AGENCY, локальном рынке Узбекистана и технической проверке digital-продуктов.
Приём онлайн-платежей в Узбекистане — это не API-ключ и коммит. Это договор с банком-эквайером, модерация контента сайта и технические требования, которые серьёзно отличаются от Stripe или PayPal. Ниже — проверенный путь подключения Click, Payme и Uzcard без сюрпризов на проде.
Краткий выбор платёжных систем для UZ
| Шлюз | Покрытие в UZ | Комиссия | Сложность подключения |
|---|---|---|---|
| Click | ~95% смартфонов | 1.5–2.5% | Средняя |
| Payme | ~85% активных | 1.5–2% | Средняя |
| Uzcard | ~70% карт UZ | 1–1.8% | Высокая (через банк) |
| Humo | ~60% карт UZ | 1.2–2% | Средняя |
| Apelsin | Узкий, но растёт | 1.8–2.5% | Низкая (Apelsin Pay API) |
| Stripe (для международных) | 0% в UZ | 2.9% + $0.30 | Низкая |
Минимальный набор для UZ e-commerce: Click + Payme + Uzcard. Этого хватает на 95% аудитории. Оставшиеся 5% обслуживаются наличными курьеру или банковским переводом.
Подключение Click: пошагово
- Зарегистрироваться в my.click.uz как мерчант. Нужны сканы: учредительные документы, ИНН, выписка из ЕГРЮЛ, паспорт директора
- Пройти модерацию сайта: действующий домен, политика конфиденциальности, договор оферты, реальные товары/услуги с ценами
- Получить `service_id`, `merchant_id`, `secret_key` и `user_id` в личном кабинете
- Реализовать endpoint `/click/prepare` для валидации заказа перед платежом
- Реализовать endpoint `/click/complete` — Click присылает финальный callback после успешной оплаты
- Добавить подписи MD5 для каждого запроса (это защита от подделки)
- Тестирование в песочнице — Click даёт тестовые реквизиты
- Активация production после подписания контракта и успешного теста
Типичные сроки: регистрация 2–7 дней, модерация 3–10 дней, техническое подключение 3–5 дней (для готового сайта), тестирование и активация 2–3 дня. Итого: **2–3 недели от заявки до первой транзакции**.
Подключение Payme: другой подход
В отличие от Click, Payme использует JSON-RPC 2.0 и требует чтобы ваш сервер сам реализовывал серию методов: `CheckPerformTransaction`, `CreateTransaction`, `PerformTransaction`, `CancelTransaction`, `CheckTransaction`, `GetStatement`. То есть не вы зовёте Payme, а Payme зовёт ваш сервер.
- Зарегистрироваться в business.paycom.uz как мерчант
- Получить merchant ID и ключ (test + production отдельно)
- Реализовать все 6 обязательных методов с правильными кодами ошибок
- Настроить basic auth для входящих запросов от Payme
- Пройти техническую проверку через тестовые транзакции
- Модерация занимает 3–7 дней
Критично: методы должны отвечать за ≤2 секунды, иначе Payme считает транзакцию зависшей. Для высоконагруженных систем используйте асинхронную обработку через очередь (Redis + BullMQ).
Uzcard и Humo: только через банк
Прямая интеграция с Uzcard и Humo невозможна для небольших мерчантов. Подключение идёт через банк-эквайер, который уже имеет контракт с Uzcard Processing Center. Популярные варианты:
- Kapitalbank (capital.uz) — активно развивает эквайринг
- Ипотека банк — широкое покрытие
- Asia Alliance Bank — быстрые KYC
- TBC Bank UZ — современный API, удобный личный кабинет
Срок подключения через банк: 3–6 недель. Нужны: договор расчётного счёта с этим же банком, лимиты по обороту, документы KYB. Для малого бизнеса без оборота банки часто требуют депозит или предоплаченную комиссию.
Архитектура приёма платежей на сайте
Рекомендуемая схема для Node.js / Fastify бэкенда:
- Frontend отправляет заказ → `POST /api/orders` → получает `order_id` + ссылки на платёжные шлюзы
- Пользователь выбирает Click/Payme/Uzcard → редирект на страницу оплаты шлюза
- После оплаты — callback на ваш сервер (webhook)
- Валидация подписи callback → обновление статуса заказа в БД
- Отправка клиенту подтверждения через email + Telegram-бот
- Фиксация транзакции в бухгалтерских записях
Подводные камни 2026
1. Тесто-специфичные поля
Click и Payme в тестовой среде разрешают реквизиты, которые prod отклоняет. Тесты оплаты должны проводиться с реальными суммами (от 1000 сум) и реальными картами — иначе вы не поймаете edge-кейсы.
2. Возвраты и частичные возвраты
По закону РУз мерчант обязан вернуть средства в течение 10 рабочих дней. Click поддерживает частичные возвраты через API, Payme — только полные. Для Uzcard возврат идёт через банк — может занять 1-3 недели.
3. Регулярные платежи / подписки
Click поддерживает tokenization с января 2025 — карта сохраняется для последующих списаний. Payme — также поддерживает через отдельный API. Uzcard официально пока нет, надо использовать ручное выставление счёта.
Юридические обязательства
- Договор оферты на сайте — обязательно
- Политика конфиденциальности — обязательно (требования ЗРУ О персональных данных)
- ИНН и ФИО мерчанта видно на странице оплаты
- Чек через онлайн-ККМ (с 2023 года для всех e-commerce > 0 сум)
- Налоговая регистрация как плательщик НДС при обороте >1 млрд сум/год
Частые вопросы
Сколько стоит подключение Click, Payme и Uzcard к сайту?
Техническая интеграция: Click — $400–800, Payme — $500–1000 (сложнее из-за JSON-RPC), Uzcard через банк — $800–1500. Полный пакет под ключ для интернет-магазина: $1500–3000. Это одноразово, плюс комиссии 1–2.5% с транзакций.
Что выбрать: Click, Payme или обе?
Для сайта/магазина в UZ подключайте обе: Click (~95% покрытие) и Payme (~85%) дополняют друг друга. Клиент сам выбирает в корзине. Если бюджет ограничен и надо выбрать одну — Click: шире покрытие, проще интеграция.
Какая комиссия у платёжных шлюзов UZ?
Click: 1.5–2.5%. Payme: 1.5–2%. Uzcard (через банк): 1–1.8%. Humo: 1.2–2%. Точная ставка зависит от объёма — чем больше оборот, тем ниже комиссия (обычно после $10 000/мес).
Нужен ли онлайн-ККМ?
Да, с 2023 года обязательно для всех e-commerce в UZ независимо от оборота. Популярные поставщики: MCHJ, PayNet, Uzum. Стоимость — $15–50/мес, интеграция через API 1–3 дня.