Написать в Telegram@Odilient
Электронная коммерция

Как подключить онлайн-оплату на сайт в Узбекистане: Click, Payme, Uzum

Oybek Odil 20 сентября 2026 г. 10 минут чтения

Что нужно до начала разработки, как на самом деле работает интеграция Click, Payme и Uzum, фискальные чеки, тестовый режим и ошибки, которые стоят денег.

В статье «Способ оплаты, которого у вас нет» мы писали, что отсутствующий способ оплаты в аналитике выглядит ровно как брошенная корзина. Это практическое продолжение для одного рынка: если вы продаёте в Узбекистане, как на самом деле подключить Click, Payme или Uzum к сайту — документы, деньги, интеграция и ошибки, которые превращают рабочую оплату в потерянные заказы.

Сначала короткий ответ — большинству, кто это ищет, нужен именно он:

  • Документы — раньше кода. Любому провайдеру нужны юрлицо или ИП, расчётный счёт и подписанный договор. Интеграция занимает неделю работы, а бумаги могут занять больше.
  • Кнопка «Оплатить» — самая простая часть. Платёж становится настоящим только тогда, когда сервер провайдера обращается к вашему серверу и получает правильный ответ. Именно в этом обратном вызове живут все серьёзные ошибки.
  • На каждый платёж выдаётся фискальный чек, и для него вашим товарам нужны коды из налогового справочника.
  • Большинство магазинов в итоге подключают двух провайдеров, а не одного. Каких именно — зависит от ваших покупателей, а не от того, чей логотип новее.

Что нужно до начала разработки

Юрлицо или ИП

Документация Click определяет мерчанта как юридическое лицо, а в инструкции по оплате через Telegram сказано прямо: чтобы принимать платежи, нужно быть зарегистрированным как юридическое лицо или индивидуальный предприниматель и заключить договор на приём платежей с одним из банков, подключённых к системе (документация Click). Uzum на странице для партнёров просит реквизиты организации (ИНН, расчётный счёт, МФО банка), свидетельство о госрегистрации, паспорт руководителя и — кроме ИП — приказ о его назначении (Uzum Bank Partners).

Если вы продаёте как физическое лицо без регистрации, остановитесь и сначала зарегистрируйтесь. Никакая интеграция не поможет, пока вы не можете подписать договор.

Документы

Самый подробный опубликованный список — у Click: свидетельство о регистрации, лицензия, если деятельность её требует, приказ о назначении директора и его паспорт, протокол собрания учредителей, устав целиком — и договор на домен (документация Click). Последний пункт важнее, чем кажется: провайдер хочет видеть, что сайт принадлежит вашему бизнесу. Если домен на своё имя зарегистрировал разработчик, исправьте это сейчас; как — мы разбирали в статье «Кому принадлежит ваш сайт».

Коды товаров для фискального чека

Каждому товару или услуге нужны код ИКПУ (MXIK) и код упаковки из национального каталога товаров на tasnif.soliq.uz. Документация Uzum Checkout называет фискализацию «обязательным процессом, установленным законодательством» и показывает, как найти оба кода в этом каталоге (Uzum Checkout). В фискальном API Click код ИКПУ, код упаковки, сумма НДС и ставка НДС отмечены как обязательные поля для каждой позиции (фискализация Click).

Сделайте это вместе с бухгалтером до того, как начнёт работать разработчик. Каталог на двести товаров без кодов — это проект по ручному вводу данных, который никто не запланировал.

Сколько это стоит: вопрос комиссии

Здесь нужно честно сказать, что нам удалось проверить, а что нет.

Click заявляет, что платы за подключение и абонентской платы нет; банку вы платите сервисный сбор в процентах от оборота, прошедшего через Click (документация Click). Сам процент устанавливается договором с банком и не публикуется.

Uzum подключает партнёров бесплатно и публикует одну цифру: 0% за оплату картой Uzum и 0,4% за карты других банков — но это условия для Uzum to'lov, его способа оплаты по QR-коду. Про онлайн-эквайринг через API сказано только, что стоимость «зависит от выбранного типа эквайринга» (Uzum Bank Partners).

Payme на страницах, которые были нам доступны в сентябре 2026 года, ставку онлайн-эквайринга не публикует.

Поэтому «типичную комиссию», которую нельзя подтвердить источником, мы печатать не будем. Что советуем вместо этого: запросите ставку письменно у каждого провайдера — под ваш оборот и вашу категорию, и задайте вместе с ней ещё три вопроса: как быстро деньги доходят до вашего счёта (Uzum обещает ежедневный вывод на расчётный счёт), стоят ли что-то возвраты и меняется ли ставка с ростом оборота.

Как на самом деле работает интеграция

Покупатель видит переход, ваш сервер — переписку

Снаружи все три выглядят одинаково: покупатель нажимает кнопку, попадает на страницу оплаты провайдера, платит картой Uzcard или Humo и возвращается. Самый простой вариант у Click — буквально ссылка на my.click.uz/services/pay с вашим ID сервиса, суммой и номером заказа (кнопка оплаты Click); у Payme есть аналогичная форма оплаты.

Возврат на ваш сайт ничего не доказывает. Открыть вашу страницу «Спасибо за заказ» может кто угодно. Заказ оплачен только тогда, когда об этом сообщил серверу провайдер, и у каждого провайдера свой протокол для этой переписки:

  • Click (Shop API) отправляет на ваш сервер два запроса. Prepare спрашивает, существует ли заказ, верна ли сумма и можете ли вы его ещё выполнить; документация Click прямо советует интернет-магазинам резервировать товар на этом этапе, чтобы его не продали повторно. Complete сообщает, что деньги списаны. Оба подписаны MD5-строкой из данных транзакции и вашего секретного ключа, и подпись нужно проверять (Click Shop API).
  • Payme (Merchant API) работает по JSON-RPC: CheckPerformTransaction, CreateTransaction, PerformTransaction, CancelTransaction, CheckTransaction и GetStatement с аутентификацией HTTP Basic. Документация требует бронировать заказ до оплаты или отмены по таймауту, запрещать покупателю менять его, а неоплаченную транзакцию Payme отменяет через 12 часов — 43 200 000 миллисекунд (Payme CreateTransaction).
  • Uzum предлагает два продукта. Checkout — платёжный шлюз для сайтов: вы регистрируете платёж, отправляете покупателя на форму Uzum, а Uzum присылает вам callback по завершении; кроме Uzcard и Humo он принимает Visa и Mastercard (Uzum Checkout). Merchant API нужен, когда покупатель платит вам из приложения Uzum Bank: вебхуки /check, /create, /confirm, /reverse и /status; транзакция, не подтверждённая в течение 30 минут, считается неуспешной, а /status при ошибке на вашем сервере повторяется до 10 раз (Uzum Merchant API).

Фискальные чеки

С тех пор как требование налогового комитета в полной мере вступило в силу в конце 2022 года, платёжные сервисы выдают фискальный чек как посредники между покупателем и продавцом (Gazeta.uz). Payme начал выдавать электронные фискальные чеки на все платежи с 24 декабря 2022 года и запросил у мерчантов код ИКПУ, ставку НДС и тип чека для того, что они продают (блог Payme).

На практике это значит, что интеграция передаёт данные по каждой позиции: Payme принимает объект detail с позициями в ответе на CheckPerformTransaction (документация Payme), у Click есть отдельный запрос для передачи позиций после оплаты (фискализация Click), а Uzum Checkout умеет фискализировать одностадийные платежи автоматически, если это включит ваш менеджер. Сохраняйте ссылку на чек, которую получаете в ответ: покупателю, которому чек понадобится следующей весной, не должно требоваться обращение в поддержку.

Тестовый режим

Все три позволяют проверить интеграцию, прежде чем сдвинется хоть один настоящий сум. Песочница Payme на test.paycom.uz прогоняет два сценария подряд — неподтверждённые транзакции с проверками безопасности, затем подтверждённые с отменой — и рекомендует тестировать запуск реальных платежей только после её успешного прохождения (песочница Payme). В документации Click есть песочница, которая отправляет Prepare и Complete на ваш сервер прямо из браузера. Uzum Checkout публикует тестовые карты Humo и Uzcard с фиксированным кодом 3-D Secure.

Сравнение

ClickPaymeUzum
Интеграция с сайтомСсылка или форма оплаты + обратные вызовы Shop APIФорма оплаты + Merchant API (JSON-RPC)Checkout API (регистрация → форма → callback)
Оплата из приложения провайдераДа, тот же Shop APIДа, тот же Merchant APIВебхуки Merchant API
В чём приходит суммаВ сумах (фискальный API — в тийинах)В тийинахВ тийинах
Как подтверждаются запросыMD5-подпись с секретным ключомHTTP BasicBasic (Merchant API), API-ключ (Checkout)
Какие таймауты учитыватьРезерв на этапе PrepareНеоплаченная транзакция отменяется через 12 чБез подтверждения 30 мин = неуспешно
КартыUzcard, HumoUzcard, HumoUzcard, Humo, Visa, Mastercard (Checkout)
Оплата в Telegram-ботеДа, через BotFatherДа, через BotFatherВ изученной документации не описано
Тестовая средаПесочница в браузереtest.paycom.uzТестовые карты
Опубликованная комиссияБез платы за подключение и абонплаты; % устанавливает банкНе опубликованаПодключение бесплатно; онлайн-ставка не опубликована

Есть ещё Paynet и прямой эквайринг карт через ваш банк. В таблицу мы их не включили, потому что не нашли публичной документации по интеграции для мерчантов, по которой можно было бы всё проверить.

Telegram-боты работают с теми же провайдерами

Если ваша витрина — бот, а не сайт (об этом мы писали в статье «Telegram — это витрина, а не мессенджер»), Click или Payme подключаются через меню Payments в BotFather: сначала тестовое подключение провайдера, затем боевое — с логином мерчанта. Бот отправляет счёт методом sendInvoice и обязан ответить на pre-checkout запрос в течение 10 секунд, иначе транзакция отменяется (Telegram). Цифровые товары по правилам Telegram — отдельный случай, они оплачиваются через Telegram Stars. Полную картину по стоимости мы разбираем в статье «Сколько стоит Telegram-бот в 2026».

Ошибки, которые обходятся дороже всего

  1. Отмечать заказ оплаченным по странице возврата. Единственный источник правды — подписанный обратный вызов на сервер. Страница возврата — это экран «проверяем оплату».
  2. Путать сумы и тийины. Shop API Click передаёт сумы; Payme и Uzum — тийины; фискальный API самого Click ждёт тийины. Храните деньги целыми числами в минимальных единицах и конвертируйте на границе — правило из статьи «Что на самом деле значит мультивалютность», применённое к одной валюте.
  3. Не резервировать товар. И Click, и Payme просят удерживать заказ между проверкой и оплатой. Без этого последнюю единицу товара могут оплатить два покупателя.
  4. Неидемпотентные обработчики. Провайдеры повторяют запросы. Uzum повторяет /status до десяти раз; у Click есть отдельная ошибка «платёж уже подтверждён». Один и тот же запрос, пришедший дважды, не должен приводить к двум отгрузкам.
  5. Отвечать ошибкой после списания денег. Click пишет прямо: если Prepare прошёл успешно и деньги с карты списаны, ответ на Complete не может быть ошибкой; если выполнить заказ невозможно, ответьте успехом и запустите отмену платежа. Ответ с ошибкой отправляет платёж на ручное расследование.
  6. Фискальные данные «на потом». Отсутствующие коды ИКПУ или упаковки всплывают на запуске, а не в тестах — если только вы не тестируете на реальном каталоге.
  7. Аккаунты не на того. Договор мерчанта, домен и доступы к кабинетам принадлежат бизнесу, а боевые ключи хранятся в конфигурации сервера — никогда в репозитории.

Сколько стоит сделать это у нас

Наши интернет-магазины стоят от $499 и делаются от одной до пяти недель, а тариф магазина на странице цен включает платёжный шлюз, склад и заказы, скидки и настройку доставки, плюс шесть месяцев поддержки. Telegram-боты с оплатой — от $199. Payme и Click есть в нашем стеке.

Честная оговорка про объём работ из прошлой статьи по-прежнему в силе: один провайдер входит в стандартную сборку магазина; второго мы оцениваем и называем цену до начала работы, чтобы вы решали, видя цифру. Документы и договор мерчанта остаются вашими: техническую часть и список кодов товаров мы готовим, но договор заключается между вашим бизнесом и банком.

Расскажите, что вам нужно. В ответ вы получите фиксированную цену и дату сдачи — бесплатно и без обязательств продолжать.

Частые вопросы

Можно ли принимать Click или Payme как физическое лицо?

Нет, если верить документам самих провайдеров. Click требует юрлицо или ИП с договором с банком, Uzum просит реквизиты организации и свидетельство о госрегистрации. Сначала зарегистрируйтесь: это самый долгий шаг, и он не зависит от разработчика.

Какого провайдера подключать первым?

Того, через которого ваши покупатели уже платят. Если данных нет, начните с Click или Payme — оба широко используются для карт Uzcard и Humo — и сохраняйте несостоявшиеся оплаты как заявки, как описано в статье «Способ оплаты, которого у вас нет». Через месяц вы будете знать, какой второй способ стоит вам продаж.

Сколько длится подключение?

Ни один из трёх провайдеров не публикует сроки. Планируйте документы, проверку со стороны провайдера и тесты в песочнице как отдельный трек, который начинается в первый же день параллельно с разработкой магазина.

Можно ли принимать карты, выпущенные за границей?

Uzum Checkout указывает Visa и Mastercard среди поддерживаемых систем. Пройдёт ли конкретная иностранная карта, зависит от вашего договора и банка-эмитента, поэтому спросите провайдера напрямую и проверьте на реальной иностранной карте, прежде чем обещать это на сайте.

Поддерживает ли этих провайдеров Tilda или другой конструктор?

У Tilda есть встроенное подключение Click для товаров из каталога, и она требует код ИКПУ и код упаковки для каждого товара (справка Tilda). Встроенного подключения Payme в справочном центре Tilda мы не нашли. Если нужны оба провайдера или своя логика вокруг заказов, именно здесь заканчивается конструктор и начинается собственная оплата.

Читайте также

Ещё в рубрике «Электронная коммерция»

Давайте обсудим

Читать об этом — самое простое

Если вы и правда решаете такую задачу, расскажите о ней. Мы скажем, что бы сделали, сколько это стоит и сколько займёт времени.

Бесплатная консультация Без обязательств Быстрый ответ