К содержимому
7 мин чтения

Подключить Payme к сайту: документы, сроки, проверка и ошибки

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

Что нужно до начала подключения

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

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

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

Как подключить Payme к сайту: пошаговый план

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

Третий шаг — разработка. Сайт создаёт заказ в базе со статусом «ожидает оплаты» и формирует ссылку на оплату с суммой и номером заказа. Дальше платёжный сервис сам обращается к вашему серверу по заранее указанному адресу. У Payme это запросы в формате JSON-RPC: проверка возможности оплаты, создание транзакции, подтверждение, отмена и выписка. Суммы Payme передаёт в тийинах, то есть в сотых долях сума: заказ на 100 000 сум — это 10 000 000 тийинов. Эту путаницу забывают чаще, чем кажется.

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

Как устроена оплата и почему статус меняет сервер

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

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

Проверяйте каждый входящий запрос: верна ли подпись или авторизация, существует ли заказ, совпадает ли сумма с рассчитанной на сервере, не оплачен ли заказ уже. Отвечайте в формате, который требует сервис, иначе операция будет считаться неуспешной.

Click, комиссии и сроки зачисления

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

Комиссия зависит от оборота, вида деятельности и договора, универсальных цифр нет. Запросите условия письменно у каждого сервиса и посчитайте, сколько вы отдадите при своём среднем чеке. Уточните также, через сколько рабочих дней деньги приходят на расчётный счёт и как проходят возвраты. Магазину обычно достаточно двух онлайн-способов и оплаты при получении: если привычного приложения нет на странице оплаты, покупатель уходит без заказа.

Тестирование и типичные ошибки

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

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

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

Можно ли подключить Payme к сайту без юридического лица? Как правило, нет: сервисы заключают договор с юрлицами и ИП. Актуальные условия уточняйте у самого сервиса.

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

Нужны ли и Payme, и Click? Не обязательно, но два способа снижают риск потерять покупателя, у которого под рукой другое приложение.

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

Можно ли подключить оплату к сайту на конструкторе? Зависит от конструктора: нужна возможность принимать серверные запросы и хранить заказы, иначе потребуется отдельный серверный модуль.

Из чего складывается стоимость и с чего начать

Цена складывается из логики заказов и корзины (если её нет), интеграции с каждым сервисом, тестирования, возвратов и раздела для просмотра платежей. Ориентир по рынку Узбекистана для подключения одного сервиса к готовому сайту — примерно от 1 500 000 до 6 000 000 сум; для интернет-магазина с нуля сумма выше и зависит от каталога. Это ориентир, итог определяется задачей.

Если сайта ещё нет, оплату лучше заложить в проект сразу. В 4 Digital создание сайтов под ключ стоит от 1 399 000 сум, и онлайн-оплату мы обсуждаем на старте вместе со структурой каталога, чтобы не переделывать заказы позже.

Нужен сайт или реклама? Обсудим ваш проект.

Создание сайтов под ключ + CRM · от 2 399000 сум

Ответим за 15 минут в рабочее время. Без спама.