Интеграции и веб-модули
Подключение оплаты через ЮKassa к сайту
Подключим ЮKassa к сайту: создание платежа, подтверждение результата, защита от повторной обработки и понятные состояния заказа.
Отправить задачуОплата должна завершать конкретный заказ
Кнопка перехода на платёжную страницу — только часть подключения. Магазину необходимо связать платёж с неизменным составом заказа, показать покупателю действительный результат и передать оплаченный заказ в дальнейшую обработку. Разбираем текущую корзину, правила доставки, скидки и момент резервирования товара. До разработки определяем, когда сумму ещё можно менять и когда требуется новая попытка оплаты.
Исходные данные: CMS или описание собственного приложения, договор и доступные способы оплаты магазина, схема статусов, правила отмены и возврата. Секреты передаются в согласованном защищённом процессе. На странице заявки достаточно описания задачи; публиковать ключи или присылать данные банковских карт не требуется.
Что считается подтверждением
По документации ЮKassa запросы к API выполняются с сервера. Возвращение браузера по return_url возможно при разных исходах и само по себе не подтверждает оплату. Заказ переводится в оплаченный статус после проверки связанного платежа; успешному завершению соответствует succeeded. Конкретную схему уведомлений и дополнительной проверки выбираем по архитектуре сайта.
Если таблица не помещается, прокрутите её вбок.
| Состояние | Что видит покупатель | Действие магазина |
|---|---|---|
| Платёж ожидает завершения | Проверяем оплату | Сохранить связь с попыткой |
| Успех подтверждён | Заказ оплачен | Однократно запустить исполнение |
| Оплата отменена | Оплата не завершена | Предложить допустимую повторную попытку |
| Ответ временно недоступен | Результат уточняется | Не выдавать товар по предположению |
Учебный сценарий с закрытой вкладкой
В учебном примере заказ состоит из двух товаров и доставки. Сервер фиксирует его итог, создаёт платёж и сохраняет полученный идентификатор. Покупатель подтверждает оплату и закрывает вкладку до возврата на сайт. Заказ всё равно должен получить корректный результат через предусмотренную серверную обработку. Повторное открытие страницы показывает уже известное состояние.
Затем имитируем повтор уведомления. Выдача цифрового товара, создание отгрузки или отправка подтверждения не должны запускаться второй раз. Отдельно проверяем несовпадение суммы и принадлежность платежа заказу: такой сигнал направляется на разбор. Изменение адреса с другой стоимостью доставки после начала оплаты не исправляется незаметной подменой суммы.
Неуспешные попытки и возвраты
Различаем заказ и несколько его платёжных попыток. Повторное нажатие кнопки не должно бесконтрольно создавать новые обязательства. Предусматриваем сообщения для отменённой оплаты, потерянного соединения и длительного ожидания. Полный или частичный возврат, если он входит в задание, получает собственную историю; возврат денег и возвращение товара на склад не считаются одним действием.
Как принимается подключение
В тестовой среде проверяем успех, отмену, повтор запроса, позднее подтверждение и недоступность обработчика. Сравниваем сумму, валюту, заказ и итоговое действие магазина. После перехода на рабочую конфигурацию согласуем контроль подключения без произвольных списаний. Фискализация проверяется в согласованной схеме с ответственным за реквизиты и чеки; готовая кнопка оплаты не означает готовность всех сопутствующих процессов.
Что входит в оценку
Оцениваем интеграцию с существующим заказом, серверную обработку, интерфейс результата и диагностику. На сложность влияют двухэтапные сценарии, частичные возвраты, несколько продавцов и цифровой доступ. Автоплатежи требуют отдельной модели периодов и согласий. Передаём перечень статусов и инструкцию оператору, чтобы спорную попытку можно было найти по номеру заказа без просмотра секретных данных.
Вопросы перед запуском
Обязательно ли возвращаться на сайт после оплаты?
Нет. Закрытая вкладка не должна мешать серверу установить результат. Страница возврата служит для понятного сообщения покупателю.
Можно ли сразу подключить подписку?
Это отдельный сценарий: нужны правила продления, отмены и доступа, а также подтверждённые возможности магазина и выбранного способа оплаты.
Гарантируется ли успешная оплата каждого заказа?
Нет. Решения банка и действия покупателя не контролируются сайтом. Задача интеграции — правильно обработать каждый полученный исход.
Обсудить задачу
Укажите CMS, что продаёт сайт и какие сценарии оплаты или возврата нужны.
Удобнее обсудить голосом? +7 (995) 001-41-87