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.
  2. Перейдите в раздел «Интеграция».
  3. Найдите «HTTP-уведомления» (или похожую формулировку для вебхуков).
  4. Введите URL для Webhook YooKassa, предоставленный iSales AI, в соответствующее поле.
  5. Сохраните настройки. Убедитесь, что вы включили уведомления об успешных платежах и других релевантных событиях.

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

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

• НДС (Налог на добавленную стоимость): (например, 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-ключах.