Подключить Payme и Click к сайту: что нужно знать владельцу

Подключить Payme и Click к сайту нужно ровно в ту минуту, когда клиент готов платить картой. Пока этого нет, вы отправляете номер карты в Telegram, клиент присылает скриншот перевода, а вы сверяете всё руками.

До пяти заказов в день так работать можно. На двадцати начинается путаница: кто оплатил, кто нет, а когда доходит до возврата — документа не найти. Бухгалтер в конце месяца листает переписку и сводит скриншоты с выпиской. С заявками ровно та же история: сообщение из профиля тонет в личной переписке, а с сайта оно попадает в базу — эту разницу мы разбирали в статье о том, что такое корпоративный сайт.

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

Что должно быть готово до подключения

Ни одна из систем не работает с физическим лицом. Нужны зарегистрированное юридическое лицо или ИП и открытый расчётный счёт в банке.

Payme Business запрашивает для договора три документа: копию паспорта руководителя, свидетельство о регистрации и свидетельство плательщика НДС, если вы им являетесь. Подписать можно на бумаге или электронной подписью.

Для активации кассы понадобится ePOS-терминал — его выдаёт обслуживающий банк. Поступления идут на расчётный счёт организации: на сайте Payme прямо сказано, что по закону все оплаты через сервис должны попадать именно туда, а не на корпоративную карту.

На стороне Click при регистрации выдают четыре значения: merchant_id, service_id, merchant_user_id и secret_key. Последний в документации помечен как конфиденциальный, и ответственность за его хранение лежит на поставщике услуг. Не пересылайте его разработчику открытым сообщением.

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

Два способа подключить Payme и Click к сайту: кнопка и биллинг

Под словами «подключить оплату» обычно понимают одну работу. На деле уровней два, и отличаются они и ценой, и мерой ответственности.

Payme отдаёт готовые плагины для распространённых CMS: WooCommerce, OpenCart 2.x и 3.x, Magento, Joomshopping, VirtueMart, 1С-Битрикс, Webasyst Shop-Script и CS-Cart. Если сайт стоит на одной из этих платформ, время интеграции резко сокращается.

Гостевому дому, который берёт предоплату за бронь, хватит обычной ссылки. Магазину посуды с корзиной, остатками и возвратами нужна биллинг-интеграция — без неё склад и заказы разъедутся в первую же неделю.

Callback — самая важная часть интеграции

Самая частая ошибка выглядит безобидно: статус заказа меняется на странице «Спасибо за покупку». Клиент закрыл вкладку сразу после оплаты — деньги списаны, а заказ у вас так и висит неоплаченным.

Правильный путь один. Статус заказа меняет только тот запрос, который платёжная система отправляет на ваш сервер. Этот запрос называют callback, и он работает независимо от браузера клиента.

Как это устроено у Payme

По документации Payme Business обмен идёт по протоколу JSON-RPC 2.0: система вызывает ваш сервер, вы отвечаете. Реализовать нужно методы CheckPerformTransaction, CreateTransaction, PerformTransaction, CancelTransaction, CheckTransaction и GetStatement.

Авторизация — обычная HTTP-аутентификация вида Authorization: Basic base64(login:password), пароль выдаётся при создании веб-кассы. Запросы приходят с фиксированного набора адресов из диапазона 185.234.113.1–15, так что их можно занести в белый список на сервере.

Как это устроено у Click

В SHOP API два этапа: Prepare (action = 0) и Complete (action = 1). Запрос приходит методом POST в формате application/x-www-form-urlencoded, а ответ ваш сервер обязан вернуть в JSON.

В каждом запросе есть sign_string — контрольная строка MD5, в которую входят номер транзакции, идентификатор сервиса, секретный ключ, номер заказа, сумма, тип действия и время платежа; на этапе Complete добавляется идентификатор, полученный в Prepare. Не проверять её — всё равно что оставить дверь открытой.

Отдельное требование документации: получив Prepare, интернет-магазин должен зарезервировать товар, чтобы одна единица не ушла двум покупателям.

Если один и тот же запрос придёт дважды

Payme при потере ответа повторяет запрос с теми же параметрами — это записано прямо в описании схемы взаимодействия. Значит, код обязан быть идемпотентным: на повторный вызов не должно создаваться второго заказа. Если ответа долго нет, процесс оплаты приостанавливается и транзакцией управляют вручную.

У Click логика похожая: когда сервер магазина несколько раз подряд отвечает ошибкой, платёж уходит в ручное разбирательство техподдержки. Есть и отдельный сценарий — деньги списаны, а отпустить товар нельзя. Документация требует ответить на Complete успехом и отдельным запросом инициировать отмену платежа.

Для фотостудии в Самарканде это разница между «всё в порядке» и двумя бронями на один павильон. Для магазина — между честным остатком на складе и извинениями перед покупателем.

Фискальный чек: деньги прошли, а чек где?

Это самая недооценённая часть. Статья 23 закона «Об электронной коммерции» требует, чтобы при оплате электронными средствами платежа электронный чек виртуальной кассы направлялся на абонентский номер покупателя, на указанный им адрес электронной почты или в личный кабинет. Текст закона — на lex.uz; это не юридическая консультация, сверяйтесь с бухгалтером и действующей редакцией.

Технически обе системы это поддерживают. Но данные для чека они ждут от вас.

• У Payme есть метод SetFiscalData. В документации отмечено, что реализовывать его не обязательно, но если реализуете — получите номер виртуального фискального модуля, фискальный признак платежа, ссылку на чек и дату его регистрации.
• Чеки приходят двух типов: на оплату и на отмену. Это два разных фискальных чека, и хранить их в базе нужно раздельно.
• У Click список товаров уходит отдельным запросом, а готовую ссылку на фискальный чек можно потом забрать обратно — она ведёт на ofd.soliq.uz.

Самое болезненное — состав данных. В документации Click по фискализации для каждой позиции обязательны название, код ИКПУ, код упаковки, количество, сумма, сумма и процент НДС, а также ИНН или ПИНФЛ. То есть коды должны быть привязаны к каждому товару каталога до запуска, а не после.

Если в каталоге четыреста позиций, это не работа на один вечер. На практике проекты застревают именно здесь на пару недель. Отдайте подготовку кодов бухгалтеру, пока разработчики собирают сайт: эти две задачи спокойно идут параллельно.

Как работает возврат денег

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

У Payme отмена идёт через CancelTransaction, и метод отменяет как созданную, так и уже проведённую транзакцию. Важная деталь: вернуть деньги можно только если этот метод реализован. Значит, возможность возврата решается на этапе интеграции, а не в день, когда клиент попросил деньги назад.

У Click отмена выполняется отдельным запросом, и условия жёсткие. По документации платёж должен быть успешно завершён и относиться к текущему отчётному месяцу; платежи прошлого месяца отменяются только в первый день текущего; оплата должна быть проведена онлайн-картой; и сама отмена может быть отклонена платёжной системой UZCARD.

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

Практический вывод для магазина одежды: напишите правило возврата в оферте и сверьте его с месячным ограничением Click. Иначе обещание «вернём в течение месяца» разойдётся с тем, что технически возможно.

Сколько комиссия и когда приходят деньги

Payme публикует тариф открыто. На 11 сентября 2026 года электронные платежи с биллингом идут по ставке 2%, платежи без биллинга — 1,5%, Payme GO и оплата на месте по QR-коду — 1%. Источник — business.payme.uz; тариф может меняться, проверьте его перед подписанием.

Там же сказано, что деньги поступают в течение одного банковского дня и зачисляются на расчётный счёт организации. У Click ставка фиксируется в договоре — просите её письменно, а не на словах.

До подписания выясните пять вещей.

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

Для детской школы плавания с сотней оплат абонементов в месяц разница в полпроцента к концу года превращается в сумму, сопоставимую с зарплатой сотрудника. Считать её стоит до договора, а не после.

Сколько времени занимает интеграция

Написать код — половина дела. Обе системы требуют тестирования до запуска.

У Payme для этого есть песочница. При создании веб-кассы выдают два ключа: один для кабинета, второй для тестовой среды. Проверка идёт по двум сценариям — создание и отмена неподтверждённой транзакции, затем создание, подтверждение и отмена подтверждённой.

В документации есть и предупреждение: тестирование на рабочем сервере создаёт дополнительную нагрузку, а учётные записи, связанные с некорректно работающими приложениями, блокируются. Подход «запустим, по ходу починим» здесь не проходит.

На практике срок растягивают три вещи: получение ePOS в банке, подготовка кодов для товаров и наведение порядка в статусах заказа на вашей стороне. Интернет-магазин мы обычно сдаём за четыре-шесть недель, магазин, связанный со складом и CRM, — за шесть-десять недель. Платёжная интеграция входит в этот срок и отдельным проектом не считается. Почему магазин делается дольше обычного сайта, показано на примере каталога и склада в разборе сроков разработки сайта.

Если заказы уже падают в Telegram и в базу, связать их с CRM-системой логично на этом же этапе — переоткрывать проект ради этого потом дороже.

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

Нужно подключать сразу и Payme, и Click?

Как правило, обе. Часть клиентов пользуется одним приложением и второе не ставит: ограничившись одной системой, вы теряете часть заказов.

Технически вторая система обходится дешевле первой — логика статусов, чеков и отчётности к этому моменту уже написана.

Можно оставить наличные и оплату курьеру?

Можно, и чаще всего нужно. Значительная часть покупателей из областей по-прежнему платит наличными при доставке.

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

Работают ли карты UzCard и Humo?

Да. В документации Payme Business сказано, что партнёр принимает оплату с банковских карт Uzcard и HUMO; у Click работают те же национальные карты.

Отдельно уточните у менеджера, какие способы включены именно в вашем договоре: набор зависит от типа кассы.

Можно проверить всё в тестовом режиме?

Да, у Payme для этого есть отдельная песочница, и прохождение сценариев считается обязательным шагом перед запуском.

Попросите у разработчика результат тестов: должно быть видно, какие сценарии пройдены и как сервер отвечает на неверную авторизацию.

У меня сайт на WordPress — хватит готового плагина?

В большинстве случаев хватит, но не всегда. Плагин рассчитан на стандартную схему корзины и заказа.

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

Могут ли деньги приходить на корпоративную карту?

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

Этот момент лучше проговорить с бухгалтером до подписания договора, чтобы потом не переоформлять реквизиты.

Подключение оплаты — не техническое задание, а набор бизнес-решений: какой тип кассы, какое правило возврата, с какими кодами товаров. Если хочется пройти эти решения не в одиночку, посмотрите раздел сайты и платформы или задайте вопросы на бесплатной консультации — она длится полчаса и ни к чему не обязывает. Работающие проекты собраны в разделе кейсы, а порядок работы и оплаты — на странице формат работы и цена.