💡 Зачем нужна эта интеграция
ВКонтакте остается одним из главных каналов продаж для малого и среднего бизнеса: клиенты пишут в сообщения сообщества, оформляют заказы в VK Маркете, общаются с чат-ботами и участвуют в рассылках. ЮKassa в этой связке отвечает за безопасный приём оплаты: банковские карты, СБП, ЮMoney, SberPay и другие способы. Без интеграции менеджер вручную выставляет счета, отправляет ссылки на оплату в личные сообщения, сверяет поступления с заказами и вручную сообщает клиенту, что платёж получен. Это медленно, приводит к ошибкам и потерянным заявкам, особенно при росте числа обращений.
Прямой «одной кнопкой» интеграции между ВКонтакте и ЮKassa, которая покрывала бы все сценарии, нет, поэтому связку обычно настраивают через платформы-коннекторы: Make, APIX-Drive, Albato, n8n или Zapier (через Webhooks и HTTP-запросы). Другой вариант — готовые модули и виджеты из маркетплейсов и конструкторов чат-ботов (например, BotHelp, Senler, LeadTex), где подключение ЮKassa уже встроено. Коннекторы подходят для нестандартной логики: платёж создаётся автоматически по событию во ВКонтакте, а результат оплаты возвращается обратно в диалог с клиентом.
В результате бизнес получает сквозную автоматизацию. Клиент пишет в сообщество или выбирает товар, система создаёт платёж в ЮKassa и сразу присылает ссылку в личные сообщения. После оплаты ЮKassa отправляет уведомление, и автоматически происходит следующее: клиент получает подтверждение и доступ к товару или курсу, статус заказа обновляется в таблице или CRM, менеджер получает оповещение, а клиент добавляется в нужный сегмент для допродаж. Это сокращает время обработки заказа с часов до секунд, снижает число ошибок и брошенных корзин, разгружает менеджеров и делает учёт оплат прозрачным.
🛠️ Как настроить интеграцию
- **Подготовьте аккаунты и доступы.** В ЮKassa создайте магазин и пройдите проверку (для тестов достаточно тестового магазина). В разделе «Интеграция → Ключи API» сохраните идентификатор магазина (shopId) и сгенерируйте секретный ключ. Во ВКонтакте откройте сообщество, затем «Управление → Работа с API → Ключи доступа» и создайте ключ с правами на сообщения (при необходимости также на товары и управление сообществом). Включите сообщения сообщества и настройте Callback API или Long Poll API, чтобы коннектор получал входящие события. Определите, какой платформой будете пользоваться: Make, APIX-Drive, Albato или конструктором чат-ботов со встроенным модулем ЮKassa.
- **Подключите ВКонтакте и ЮKassa в платформе-коннекторе.** Создайте новый сценарий (в Make это Scenario, в APIX-Drive это связка). В качестве источника данных добавьте модуль ВКонтакте и авторизуйтесь через ключ сообщества. Триггером может быть новое входящее сообщение, ключевое слово, новый заказ в VK Маркете или нажатие кнопки в чат-боте. Для ЮKassa добавьте готовый модуль, если он есть на платформе. В противном случае используйте HTTP-модуль с запросом `POST https://api.yookassa.ru/v3/payments` и авторизацией Basic Auth (shopId как логин, секретный ключ как пароль). Обязательно добавьте заголовок `Idempotence-Key` с уникальным значением, чтобы повторный запуск сценария не создал дубль платежа.
- **Настройте создание платежа и отправку ссылки клиенту.** В теле запроса к ЮKassa передайте сумму и валюту (RUB), описание заказа, тип подтверждения `redirect` с адресом возврата `return_url` (например, ссылка на сообщество). В поле `metadata` сохраните идентификатор пользователя ВКонтакте (`vk_user_id`) и номер заказа, они понадобятся для связи оплаты с диалогом. Если вы работаете по 54-ФЗ, добавьте данные чека: email или телефон покупателя и список позиций. Из ответа ЮKassa возьмите `confirmation_url` и следующим модулем «Отправить сообщение» (`messages.send`) отправьте его клиенту в личные сообщения с текстом вроде «Ваш заказ №… ждёт оплаты» и кнопкой оплаты.
- **Настройте обратную связь: уведомления об оплате.** В личном кабинете ЮKassa откройте «Интеграция → HTTP-уведомления» и укажите URL вебхука из коннектора (в Make это модуль Custom Webhook, в APIX-Drive это приём данных по webhook). Включите события `payment.succeeded`, `payment.canceled` и при необходимости `refund.succeeded`.