💡 Зачем нужна эта интеграция
Компании, которые принимают платежи через ЮKassa, часто ведут учёт в Google Таблицах: реестр оплат, список клиентов, воронку продаж, отчёты для бухгалтерии. Без автоматизации менеджеру или бухгалтеру приходится выгружать отчёты из личного кабинета ЮKassa и вручную переносить данные в таблицу. Это занимает время, а ошибки в суммах, датах и номерах заказов приводят к расхождениям в отчётности. Интеграция делает так, чтобы каждый успешный платёж, возврат или отмена сразу появлялись в таблице отдельной строкой.
Прямой «нативной» кнопки интеграции между ЮKassa и Google Таблицами нет, поэтому связку настраивают через платформы-коннекторы: Make (Integromat), Zapier или APIX-Drive. Для российских проектов часто удобнее APIX-Drive, где ЮKassa и Google Таблицы подключаются через готовые коннекторы. В Make и Zapier обычно используют приём вебхуков: ЮKassa отправляет HTTP-уведомление о событии, а платформа записывает данные в таблицу. Если вы подключаете ЮKassa через CMS или конструктор сайтов, иногда можно использовать готовые виджеты и модули из их маркетплейсов, но для гибкой выгрузки в Google Таблицы коннектор остаётся самым надёжным вариантом.
Автоматизация решает сразу несколько задач. Она создаёт актуальный реестр платежей в реальном времени, убирает ручной ввод и снижает число ошибок. На основе таблицы можно строить сводные отчёты, графики выручки и сверки с бухгалтерией, а также передавать данные в другие системы: CRM, рассылки, Telegram-уведомления менеджерам. Отдел продаж видит статус оплаты без доступа к личному кабинету ЮKassa, а руководитель получает прозрачную аналитику по продуктам, каналам и периодам.
🛠️ Как настроить интеграцию
- **Подготовьте таблицу и доступы.** Создайте в Google Таблицах файл, например «Платежи ЮKassa». В первой строке задайте заголовки столбцов: дата и время, ID платежа, статус, сумма, валюта, описание, ID заказа или метаданные, e-mail клиента, способ оплаты, сумма возврата. Убедитесь, что у вас есть доступ к личному кабинету ЮKassa (магазин с активным shopId) и к Google-аккаунту с правом редактирования файла. В личном кабинете ЮKassa в разделе «Интеграция → Ключи API» получите секретный ключ. Он понадобится, если вы будете запрашивать данные платежа через API.
- **Выберите платформу-коннектор и создайте сценарий.** Зарегистрируйтесь в Make, Zapier или APIX-Drive.
- В APIX-Drive создайте новое соединение. Источником данных выберите ЮKassa, приёмником Google Таблицы. Авторизуйте оба сервиса по инструкции платформы.
- В Make создайте сценарий с модулем *Webhooks → Custom webhook* в качестве триггера и модулем *Google Sheets → Add a Row* в качестве действия.
- В Zapier используйте триггер *Webhooks by Zapier → Catch Hook* и действие *Google Sheets → Create Spreadsheet Row*.
При первом подключении Google Таблиц разрешите платформе доступ к вашему аккаунту и выберите нужный файл и лист.
- **Настройте передачу событий из ЮKassa.** Если коннектор не опрашивает ЮKassa сам, а работает через вебхук, скопируйте URL вебхука из Make или Zapier. В личном кабинете ЮKassa откройте «Интеграция → HTTP-уведомления», вставьте этот URL и включите нужные события:
- `payment.succeeded` для успешной оплаты;
- `payment.canceled` для отмены;
- `payment.waiting_for_capture` для платежей, ожидающих подтверждения;
- `refund.succeeded` для возвратов.
Сохраните настройки. Затем отправьте тестовый платёж или запустите прослушивание вебхука в коннекторе, чтобы платформа распознала структуру данных.
- **Сопоставьте поля и добавьте логику.** В модуле записи в Google Таблицы сопоставьте данные уведомления со столбцами:
- `object.id` → ID платежа;
- `object.status` → статус;
- `object.amount.value` → сумма;
- `object.amount.currency` → валюта;
- `object.created_at` → дата;
- `object.description` → описание;
- `object.metadata` → номер заказа и другие ваши параметры.
Добавьте фильтры, чтобы в таблицу попадали только нужные события. Для возвратов можно создать отдельный лист или писать данные в тот же лист с пометкой типа операции. Чтобы избежать дублей, используйте поиск строки по ID платежа (Search Rows в Make, Lookup в Zapier) и обновляйте существующую строку вместо добавления новой. Для надёжности можно добавить шаг, который запрашивает платёж по API ЮKassa и сверяет его статус.
- **Протестируйте интеграцию и запустите её в работу.** Проведите тестовый платёж на небольшую сумму или используйте тестовый магазин ЮKassa. Проверьте по шагам:
- сработал ли вебхук и появился ли запуск в истории сценария (в Make это Execution History, в Zapier Zap History, в APIX-Drive журнал соединения);
- появилась ли в Google Таблице новая строка с правильными суммой, статусом, датой и ID платежа;
- корректно ли обрабатывается возврат: данные должны добавиться или обновиться по нужному ID;
- нет ли дублей при повторной отправке уведомления.
Если данные не пришли, проверьте URL вебхука, выбранные события, права доступа к таблице и сопоставление полей. После успешных тестов включите сценарий в постоянный режим и настройте уведомления об ошибках на e-mail или в мессенджер. В течение первых дней сверяйте записи в таблице с отчётом ЮKassa, чтобы убедиться, что все операции переносятся полностью.