💡 Зачем нужна эта интеграция
ЮKassa и Авито не связаны прямой интеграцией «в один клик». У Авито нет готового модуля приема платежей через ЮKassa, а у ЮKassa нет встроенного коннектора с мессенджером и объявлениями Авито. Связку собирают через платформы-коннекторы (Make, APIX-Drive, Albato, n8n, Zapier, если он доступен в вашем регионе), через CRM с официальными виджетами из маркетплейсов (amoCRM, Битрикс24) или через собственный код на API обоих сервисов.
Для бизнеса, который получает заказы и заявки с Авито, главная проблема в том, что путь от первого сообщения покупателя до оплаты разорван. Клиент пишет в чат, менеджер вручную выставляет счет или присылает реквизиты, потом ждет подтверждения и сверяет поступления с выпиской. Это занимает время, провоцирует ошибки и приводит к потере клиентов, которые «остыли» за время ожидания. Связка ЮKassa и Авито позволяет автоматически создавать платеж под конкретную сделку, отправлять клиенту ссылку на оплату и сразу узнавать, что деньги получены. Оплата банковской картой, через СБП или ЮMoney делает процесс привычным и безопасным для покупателя, а продавцу не нужно вручную проверять поступления.
Автоматизация охватывает весь цикл. Новое обращение из чата Авито попадает в CRM или таблицу и создает сделку. После согласования условий система формирует платеж в ЮKassa с нужной суммой и описанием, а ссылка уходит клиенту в диалог. Когда ЮKassa присылает уведомление `payment.succeeded`, сделка автоматически переходит в статус «Оплачено», клиенту приходит подтверждение, а ответственный сотрудник получает задачу на отгрузку, запись или выезд. Если платеж отменен или просрочен, срабатывает напоминание. Это сокращает время обработки заявки, снижает число ошибок и дает прозрачную аналитику по каналу: сколько обращений с Авито дошло до оплаты и какова средняя сумма чека.
Такая связка особенно полезна для услуг (ремонт, монтаж, обучение, аренда), для товаров с предоплатой и для B2B-сегмента, где сделки заключаются через переписку. Учитывайте правила Авито: платформа ограничивает передачу внешних платежных ссылок и контактов в части категорий и для отдельных типов аккаунтов. Перед запуском проверьте условия для вашей категории и аккаунта (например, Авито Pro), а где доступна «Авито Доставка» с безопасной сделкой, используйте штатные инструменты площадки.
🛠️ Как настроить интеграцию
- **Шаг 1. Подготовьте доступы и выберите способ интеграции.** В личном кабинете ЮKassa завершите подключение магазина и скопируйте `shopId` и секретный ключ (раздел «Интеграция → Ключи API»). Для начала работы включите тестовый магазин. На стороне Авито получите доступ к API: в профиле (раздел для разработчиков / Авито Pro) создайте приложение и сохраните `client_id` и `client_secret`, а также включите нужные права: сообщения мессенджера, объявления, заказы. Затем определите способ связки. Это может быть платформа-коннектор (Make, APIX-Drive, Albato, n8n), CRM с виджетами из маркетплейса (amoCRM или Битрикс24 с подключенными Авито и ЮKassa) либо собственный сервис. Если у коннектора нет готового модуля для одного из сервисов, используйте универсальные модули HTTP-запросов и Webhooks.
- **Шаг 2. Создайте сценарий и настройте триггер со стороны Авито.** В коннекторе добавьте новый сценарий и авторизуйте Авито по данным OAuth из шага 1. В качестве триггера выберите событие «новое сообщение в мессенджере» или «новый заказ». Если готового триггера нет, зарегистрируйте webhook через API мессенджера Авито на URL-адрес сценария. Добавьте фильтры: реагировать только на входящие сообщения, на нужные объявления, на ключевые слова («оплатить», «счет») или на статус сделки в CRM, например «Согласовано». Следующим действием создайте или обновите сделку в CRM или строку в Google Таблицах, сохранив `chat_id`, `user_id`, `item_id` и контакты клиента. Эти идентификаторы понадобятся позже, чтобы вернуть ответ в нужный диалог.
- **Шаг 3. Настройте создание платежа в ЮKassa.** Добавьте модуль, который отправляет `POST https://api.yookassa.ru/v3/payments` с базовой авторизацией (`shopId` и секретный ключ). В теле запроса передайте сумму и валюту, описание заказа, `confirmation.type = redirect` и `return_url` (страницу «Спасибо» или ссылку обратно на ваш сайт). Включите `capture: true` для автоматического списания. Если нужен чек по 54-ФЗ, добавьте блок `receipt` с email или телефоном покупателя и позициями. В `metadata` запишите номер сделки и `chat_id` Авито, чтобы потом связать платеж с диалогом. Обязательно передавайте уникальный заголовок `Idempotence-Key`, иначе при повторном запуске сценария возможны дубли платежей. Из ответа возьмите `confirmation.confirmation_url`.
- **Шаг 4. Отправьте ссылку клиенту и настройте обработку оплаты.** Добавьте модуль отправки сообщения в чат Авито через API месс