Get Started

YooKassa Процессинг Платежей

Интеграция с YooKassa: Руководство по обработке платежей

Подключите ваш iSales AI Chatbot к YooKassa, чтобы предложить широкий спектр локализованных способов оплаты, популярных в России и странах СНГ. Это руководство поможет вам настроить интеграцию с YooKassa, позволяя вашему боту беспрепятственно обрабатывать платежи за ваши товары и услуги.

Статус интеграции с YooKassa:

  • Статус YooKassa: (например, 🟡 Выкл / Неактивно) – Этот индикатор показывает, включена или отключена в данный момент обработка платежей через YooKassa для вашего AI-чат-бота.

Основные настройки подключения YooKassa:

Чтобы связать ваш iSales AI Chatbot с вашим аккаунтом YooKassa, вам понадобятся следующие данные:

  • ID аккаунта YooKassa: (например, не указан) - Что это: Ваш уникальный идентификатор для вашего магазина или аккаунта в системе YooKassa. - Как найти: Войдите в свой личный кабинет YooKassa (панель управления мерчанта). Ваш ID аккаунта (часто упоминается как shopId) будет доступен в настройках вашего аккаунта или в деталях интеграции.

  • Секретный ключ YooKassa: (например, не указан) - Что это: Секретный API-ключ, предоставляемый YooKassa, который аутентифицирует запросы от iSales AI Bot к вашему аккаунту YooKassa. Храните этот ключ в тайне. - Как найти: В вашем личном кабинете YooKassa перейдите в настройки интеграции, а именно в раздел для API-ключей (часто с названием «Интеграция» -> «API-ключи»). Сгенерируйте или получите свой секретный ключ здесь.

❗ Важное предварительное условие: Настройка Webhook

Важно перед началом: Чтобы iSales AI Bot мог получать информацию об оплаченных счетах и корректно обновлять статусы транзакций, вы должны настроить HTTP-уведомления (webhook) в вашем личном кабинете YooKassa.

  • URL для Webhook YooKassa (предоставляется iSales AI): https://api.isales.ai/payment/yookassa (или аналогичный уникальный URL, предоставленный в вашей панели управления iSales AI).

  • Как настроить в YooKassa: 1. Войдите в свой личный кабинет YooKassa. 1. Перейдите в раздел «Интеграция». 1. Найдите «HTTP-уведомления» (или похожую формулировку для вебхуков). 1. Введите URL для Webhook YooKassa, предоставленный iSales AI, в соответствующее поле. 1. Сохраните настройки. Убедитесь, что вы включили уведомления об успешных платежах и других релевантных событиях.

Настройка налогов и товаров:

Адаптируйте обработку платежей в соответствии с фискальными требованиями вашего бизнеса:

  • НДС (Налог на добавленную стоимость): (например, without_vat) – Укажите ставку НДС, применимую к вашим продажам. Варианты обычно включают: - Без НДС (По умолчанию/Выбрано на скриншоте) - НДС 0% - НДС 10% - НДС 20% - Выберите вариант, который соответствует вашим налоговым обязательствам.

  • Система налогообложения: (например, common_system) – Выберите систему налогообложения, по которой работает ваш бизнес. Распространенные варианты могут включать: - ОСН / common_system (По умолчанию/Выбрано на скриншоте) - УСН (доходы) - УСН (доходы минус расходы) - Патент - Выберите систему, применимую к вашему юридическому лицу в вашем регионе.

  • Тип товара: (например, product) – Определите общую природу того, что вы продаете. - Товар (По умолчанию/Выбрано на скриншоте): Обычно для материальных товаров или отдельных цифровых продуктов. - Услуга: Для оказываемых услуг.

Управление вашей интеграцией с YooKassa:

Интерфейс предоставляет несколько кнопок для настройки и управления интеграцией:

  • 🔑 Обновить секретный ключ YooKassa (Кнопка): Нажмите, чтобы ввести или обновить ваш секретный ключ YooKassa.

  • 🆔 Обновить ID аккаунта YooKassa (Кнопка): Нажмите, чтобы ввести или обновить ваш ID аккаунта YooKassa (shopId).

  • ——| Обработка YooKassa |—— - 🟢 Включить / Отключить (Переключатели): Активирует или деактивирует YooKassa как способ оплаты.

  • ——| НДС |—— - Кнопки для Без НДС, НДС 0%, НДС 10%, НДС 20% для выбора соответствующей ставки НДС.

  • ——| Система налогообложения |—— - Кнопки для ОСН, УСН (доходы), УСН (доходы минус расходы), Патент для выбора вашей системы налогообложения.

  • ——| Тип товара |—— - Кнопки для Товар и Услуга для определения типа товара по умолчанию.

  • ↩️ Назад (Кнопка): Возвращает в главное меню «Обработка платежей для AI-бота».

Правильно введя ваши учетные данные YooKassa, настроив критически важный вебхук и сконфигурировав налоговые и товарные детали, вы сможете без проблем интегрировать YooKassa с вашим iSales AI Chatbot, предлагая вашим клиентам знакомый и удобный способ оплаты. Всегда обращайтесь к официальной документации YooKassa за самой актуальной информацией о их настройках и API-ключах.