Интеграция Click и Payme: оплата на сайте и в боте

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

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

Как работает онлайн-оплата

Если упростить, схема выглядит так:

1. Клиент оформляет заказ на сайте или в боте, система создаёт его в статусе «ожидает оплаты».
2. Клиента перенаправляют на платёжную страницу или открывают окно оплаты, он платит картой или через приложение.
3. Платёжная система отправляет на ваш сервер уведомление (callback) о платеже.
4. Сервер проверяет уведомление, переводит заказ в статус «оплачен» и отправляет клиенту подтверждение.
5. Деньги поступают на расчётный счёт в сроки по договору, за вычетом комиссии провайдера.

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

Локальные карты: Humo и Uzcard

Большинство жителей Узбекистана пользуются локальными картами Humo и Uzcard. Click и Payme с ними работают, поэтому для местной аудитории обычно подключают именно эти системы, а не международный эквайринг. Клиент платит в привычном приложении или вводит данные карты и подтверждает платёж кодом из SMS.

Какие системы подключать

Обычно Click и Payme подключают вместе: часть покупателей привыкла к одному сервису, часть — к другому. В зависимости от аудитории можно добавить и других провайдеров, например Uzum Bank. С каждой системой заключается отдельный договор и делается отдельная интеграция, но все заказы стекаются в одну базу.

Что нужно бизнесу

До начала технической работы стоит закрыть организационные вопросы. Обычно требуются:

• юридическое лицо или ИП (в Узбекистане — YaTT);
• расчётный счёт в банке, куда будут поступать платежи;
• мерчант-договор с платёжной системой;
• работающий сайт или бот: провайдеры нередко проверяют, что на нём есть товары или услуги, цены, контакты и публичная оферта или условия использования.

Точный список документов и размер комиссии зависят от провайдера и вида деятельности — их лучше запросить напрямую у платёжной системы.

Про фискализацию

Платёжные системы могут требовать передавать в данных чека код МХИК (ИКПУ) каждого товара и другие реквизиты. Эти требования со временем меняются, поэтому на старте проекта уточните их у провайдера и бухгалтера. Со своей стороны мы заранее закладываем нужные поля в каталог товаров.

Этапы интеграции

В общих чертах подключение Click или Payme проходит так.

1. Регистрация мерчанта

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

2. Тестовая среда

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

3. Серверная часть

Это сердце интеграции:

• адреса для callback (webhook), куда платёжная система отправляет запросы;
• проверка подписи или авторизации каждого запроса — иначе злоумышленник сможет прислать поддельное «оплачено»;
• сверка суммы и номера заказа с данными в базе;
• статусы заказа: создан, ожидает оплаты, оплачен, отменён, возвращён;
• защита от повторной обработки, если одно и то же уведомление придёт дважды.

4. Интерфейс для клиента

Кнопки выбора способа оплаты на сайте, ссылка на оплату в боте или в Telegram Mini App, страницы успешной и неуспешной оплаты.

5. Тестирование и запуск

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

Оплата на сайте и в боте: в чём разница

Основная логика одинакова: заказ, оплата, callback, обновление статуса. Различается только интерфейс.

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

В Telegram-боте ссылка на оплату приходит сообщением, либо платёж проходит через встроенные платежи Telegram с провайдером, подключённым в BotFather. После оплаты бот сам присылает подтверждение — для клиента это очень удобно. Подробнее о ботах: разработка Telegram-ботов.

Из нашей практики

• Wallner: магазин в Telegram Mini App, оплата через Click и Payme, заказы попадают в ERP-систему.
• Virtual Printer: Telegram-бот, оплата услуги через Click.
• abilet: онлайн-продажа автобусных билетов с оплатой картами Humo и Uzcard.

Во всех трёх проектах оплата не прикручена сбоку, а встроена в процесс заказа: после платежа клиент автоматически получает билет, чек или подтверждение.

Типичные ошибки

• менять статус заказа по странице возврата, а не по callback;
• не проверять подпись запросов;
• не сверять сумму и валюту с заказом в базе;
• не предусмотреть отмены и возвраты;
• хранить ключи в коде или в открытом репозитории.

Итог

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

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