💡 Зачем нужна эта интеграция
Интеграция Авито и ЮKassa нужна компаниям, которые получают заявки с Авито, а оплату принимают на своём сайте или по ссылке: услуги, ремонт, аренда, обучение, B2B-поставки, предзаказы, предоплата и частичная оплата. Без автоматизации менеджер сам ведёт диалог в чате Авито, вручную выставляет счёт в личном кабинете ЮKassa, копирует ссылку, а потом проверяет поступление денег и сверяет платёж с конкретным клиентом. Это занимает время, приводит к ошибкам в суммах и забытым счетам, а клиент остывает, пока ждёт ссылку.
Простой «нативной» интеграции в один клик между этими сервисами нет: Авито и ЮKassa не обмениваются данными напрямую. Связку настраивают через платформы-коннекторы (Make, APIX-Drive, Albato, n8n, Zapier через Webhooks и HTTP-запросы) либо через готовые виджеты и модули CRM из маркетплейсов, если ваша CRM уже подключена к обоим сервисам. Коннектор получает событие из Авито (новое сообщение, заявка, отклик), создаёт платёж через API ЮKassa, возвращает клиенту ссылку на оплату и фиксирует результат в CRM, таблице или мессенджере.
Что это даёт бизнесу:
- Ссылка на оплату уходит клиенту в чат за секунды, а не через часы.
- Каждый платёж привязан к конкретному чату или сделке через метаданные, поэтому путаницы нет.
- Статус оплаты автоматически попадает в CRM, а менеджер получает уведомление.
- Чеки по 54-ФЗ формируются автоматически.
- Меньше ручной рутины, выше конверсия из диалога в оплату, прозрачнее аналитика: видно, сколько денег принесло каждое объявление.
Важно учитывать правила Авито. Для товаров с Авито Доставкой и «Безопасной сделкой» используйте штатные инструменты площадки. Внешнюю оплату через ЮKassa применяйте там, где это допустимо правилами: для услуг, предоплаты, повторных клиентов и B2B. Перед запуском проверьте актуальные условия площадки.
🛠️ Как настроить интеграцию
- **Подготовьте доступы в обоих сервисах.**
- В Авито убедитесь, что у вас профессиональный аккаунт, и получите доступ к API: в личном кабинете в разделе для разработчиков создайте приложение и получите `client_id` и `client_secret`. Также понадобится `user_id` аккаунта. Для работы с сообщениями подключите нужные права (мессенджер) и включите webhook-уведомления о новых сообщениях.
- В ЮKassa зарегистрируйте магазин и получите `shopId` и секретный ключ (раздел «Интеграция» → «Ключи API»). Сначала используйте тестовый магазин, чтобы не проводить реальные платежи.
- Если нужны чеки, подключите онлайн-кассу или «Чеки от ЮKassa» и уточните систему налогообложения и ставку НДС.
- **Выберите платформу-коннектор и создайте сценарий.** Подойдут Make, APIX-Drive, Albato или n8n. Zapier тоже можно использовать, но тогда обращения к API делают через модули Webhooks и HTTP. Проверьте, есть ли в выбранной платформе готовые модули Авито и ЮKassa. Если их нет или не хватает действий, используйте универсальные HTTP-модули и обращайтесь к API напрямую. Если вы работаете в CRM (например, amoCRM, Битрикс24, RetailCRM), сначала поищите в её маркетплейсе виджеты для Авито и ЮKassa. Они могут закрыть часть задач без коннектора. Создайте новый сценарий и добавьте триггер «Новое сообщение или заявка из Авито». Передайте в него данные: `chat_id`, `user_id`, текст сообщения, имя клиента и ID объявления.
- **Настройте создание платежа в ЮKassa.** Добавьте следующим шагом запрос на создание платежа (`POST /v3/payments`) с авторизацией по `shopId` и секретному ключу.
- Сумму и описание берите из CRM, прайс-листа или из условия, например по ключевому слову или этапу сделки.
- Укажите `confirmation.type = redirect` и `return_url`, чтобы клиент вернулся на страницу благодарности.
- В `metadata` положите `avito_chat_id`, ID сделки или объявления. По ним вы позже сопоставите платёж с клиентом.
- Добавьте уникальный ключ идемпотентности (`Idempotence-Key`), чтобы при повторном срабатывании сценария не создавались дубли.
- Если нужны чеки, заполните блок `receipt` с email или телефоном покупателя, названием позиции, ценой и НДС.
Из ответа ЮKassa возьмите `confirmation_url`, то есть ссылку на оплату.
- **Отправьте ссылку клиенту и настройте обработку оплаты.**
- Добавьте шаг «Отправить сообщение в чат Авито» (метод мессенджера Авито для отправки сообщения в `chat_id`). Текст может быть таким: «Здравствуйте! Ссылка для оплаты заказа на сумму X ₽: [ссылка]. Она действует N часов».
- В личном кабинете ЮKassa в настройках уведомлений включите HTTP-уведомления и укажите адрес webhook вашего коннектора. Отметьте события `payment.succeeded`, `payment.canceled` и при необходимости `refund.succeeded`.
- Создайте второй сценарий с триггером «Webhook от ЮKassa». Он должен найти сделку по `metadata`, изменить её статус на «Оплачено» (или «Отменено»), записать сумму и дату в CRM или Google Таблицу, уведомить менеджера в Telegram или на почту и отправить клиенту в чат Авито подтверждение: «Оплата получена, спасибо!».
- Добавьте обработку ошибок: повторные попытки при сбое API, уведомление ответственному и проверку статуса