Интеграция ЮKassa: настройка приёма платежей за 3–7 дней
Интернет-магазин теряет до 30% заказов, если платёжная форма глючит или не поддерживает любимый банк. Покупатель бросает корзину, когда вместо ожидаемой оплаты картой видит пустой экран или ошибку. Интеграция ЮKassa решает эту задачу за 2–5 рабочих дней: настраиваем приём всех популярных способов — карты, СБП, ЮMoney, Apple Pay и Google Pay.
Мы работаем с ЮKassa (бывшая Яндекс.Касса) более 5 лет и провели интеграцию для 50+ проектов — от лендингов до маркетплейсов с тысячами SKU. Используем современный стек: React или Vue на фронте, Laravel или Node.js на бэке, Docker для изолированного тестирования. Каждый этап покрываем автоматическими тестами, чтобы исключить ошибки при запуске.
По данным ЮKassa, встраиваемый виджет увеличивает конверсию в 1,2 раза по сравнению с редиректом. — документация ЮKassa
Почему стоит выбрать встраиваемый виджет?
ЮKassa предлагает три способа интеграции: редирект на страницу системы, встраиваемый виджет и прямая работа через API. Виджет — золотая середина: пользователь не уходит с вашего сайта, а вы получаете полный контроль над дизайном. По нашей статистике, встраиваемый виджет увеличивает конверсию на 15–25% по сравнению с редиректом.
| Способ | Сложность | Время | Гибкость |
|---|---|---|---|
| Редирект | Низкая | 1–2 дня | Минимальная |
| Виджет | Средняя | 2–3 дня | Высокая (кастомизация UI) |
| API | Высокая | 3–5 дней | Максимальная (сложные сценарии) |
Для большинства интернет-магазинов мы рекомендуем виджет. Он поддерживает Apple Pay и Google Pay «из коробки» и не требует сертификатов PCI DSS.
Как обрабатывать webhook-уведомления?
ЮKassa присылает POST-запросы на ваш сервер при каждом изменении статуса платежа. Без правильной обработки магазин потеряет деньги или отправит товар дважды. Согласно документации ЮKassa, ключевые моменты:
// routes/webhooks.php Route::post('/webhooks/yookassa', [YookassaWebhookController::class, 'handle']) ->withoutMiddleware([VerifyCsrfToken::class]); - Проверяйте IP-отправителя по списку из документации
- Верифицируйте подпись запроса
- Отвечайте
200 OKдо выполнения бизнес-логики - Обрабатывайте идемпотентно — одно событие может прийти дважды
Детали проверки webhook
IP-адреса ЮKassa: https://yookassa.ru/developers/using-api/webhooks/#ip. Подпись формируется по алгоритму HMAC-SHA256 с использованием секретного ключа. Всегда отвечайте 200 OK сразу, а обработку ставьте в очередь.
Как интеграция ЮKassa помогает соблюдать 54-ФЗ?
ЮKassa автоматически формирует фискальные чеки для каждого платежа, если вы подключите онлайн-кассу. Мы настраиваем отправку чеков через API ЮKassa, чтобы ваш бизнес соответствовал требованиям законодательства. Это избавляет от штрафов и упрощает отчётность.
Этапы интеграции
| Этап | Действия | Срок | Результат |
|---|---|---|---|
| Аналитика | Изучаем бизнес-процессы, выбираем способ интеграции | 1 день | ТЗ, макет платёжной формы |
| Разработка | Настройка бэкенда (shopId, webhook), верстка виджета | 2–3 дня | Работающий модуль в тестовом окружении |
| Тестирование | Проверка успешной оплаты, отказов, возвратов, ошибок сети | 1 день | Протокол тестирования |
| Деплой | Выкатка на продакшен, мониторинг логов, обучение менеджера | 1 день | Стабильная работа, документация |
Что входит в результат?
- Полный пакет: документация, доступы, обучение и поддержка
- Документация: схема платежных потоков, описание webhook-событий, инструкция для оператора
- Доступы: создание shopId, secretKey, настройка тестовой и боевой среды
- Обучение: 30-минутный вебинар для менеджеров, ответы на вопросы в чате
- Поддержка: 2 недели бесплатного сопровождения после запуска
Требования к серверу
| Компонент | Требование |
|---|---|
| PHP | 8.0+ (или Node.js 18+) |
| Расширения | cURL, OpenSSL |
| Cron | Для обработки повторных уведомлений |
| Очереди (Laravel) | Redis или аналог |
Возвраты и отложенные платежи
ЮKassa поддерживает полные и частичные возвраты через API. Например, клиент передумал и хочет вернуть половину суммы заказа:
$refund = $client->createRefund([ 'payment_id' => $payment->getId(), 'amount' => ['value' => '500.00', 'currency' => 'RUB'], 'description' => 'Частичный возврат' ]); Важно обрабатывать возвраты идемпотентно — один запрос не должен создать два возврата.
Сроки и стоимость
Срок интеграции — от 3 до 7 рабочих дней. Точная стоимость рассчитывается индивидуально после анализа вашего проекта. Мы бесплатно консультируем по выбору способа интеграции и готовим смету за один час. Закажите интеграцию ЮKassa уже сегодня — расскажем, как подключить ЮKassa на ваш сайт и начать принимать платежи через неделю. Получите бесплатную оценку вашего проекта.