Введение
Подключение онлайн-оплаты к Telegram-магазину — это важный шаг для автоматизации продаж и повышения доверия покупателей. С помощью платформы YWI и сервиса YooKassa вы можете принимать платежи картами прямо в вашем Telegram-миниаппе без необходимости в сложных интеграциях.
В этой статье мы подробно разберём процесс подключения YooKassa к вашему маркетплейсу в YWI. Процесс занимает около 15-20 минут и не требует технических знаний — достаточно следовать инструкции.
📋 Что вам понадобится:
- Аккаунт в YooKassa (или зарегистрироваться заранее)
- Доступ к административной панели YWI
- Готовая площадка в YWI
- Около 15-20 минут свободного времени
Подготовка: регистрация в YooKassa
Если у вас ещё нет аккаунта в YooKassa, начните с регистрации. Перейдите по ссылке на инструкцию и выполните все указанные пункты.
Регистрация происходит по этой ссылке. После регистрации следуйте шагам в личном кабинете и создайте новый магазин.
Важно: В зависимости от типа регистрации (ИП, ООО, самозанятый) процесс верификации может занять от нескольких часов до нескольких дней. Рекомендуем пройти регистрацию заранее, чтобы не задерживать подключение оплаты.
Настройка в административной панели YWI
Войдите в административную панель YWI и перейдите к нужной площадке. В панели управления откройте вкладку "Дополнительные модули" и выберите модуль "YooKassa".
В разделе подключения YooKassa заполните все обязательные поля: Shop ID и Secret Key. Эти данные можно найти в вашем личном кабинете YooKassa.
Как найти Shop ID: В личном кабинете YooKassa откройте вкладку со списком магазинов и у нужного магазина нажмите на значок копирования Shop ID.
Как найти Secret Key: Откройте вкладку "Интеграция" → "Ключи API". Скопируйте секретный ключ. Если ключа нет, нажмите кнопку "Сгенерировать".
Скопируйте URL для уведомлений из окна подключения модуля в YWI (поле "URL для уведомлений YooKassa").
Перейдите в личный кабинет YooKassa во вкладку "Интеграция" → "HTTP уведомления" и нажмите "Изменить настройки".
Установите галочки напротив следующих событий:
- payment.succeeded
- payment.waiting_for_capture
- payment.canceled
Вставьте скопированный URL в поле "URL для уведомлений" и сохраните изменения.
Активация оплаты в настройках заказа
В административной панели YWI откройте вкладку "Настройки оформления заказа" и добавьте новый тип оплаты.
Придумайте название типа оплаты, например "Картой онлайн", добавьте описание и выберите модуль "yookassa" в разделе "Доступные модули оплаты".
Готово! Теперь ваши покупатели смогут оплачивать заказы картами прямо в Telegram. Оплата будет обрабатываться автоматически, а статусы заказов будут обновляться в реальном времени.
Проверка работы оплаты
После настройки рекомендуем протестировать оплату. YooKassa предоставляет тестовый режим для проверки интеграции без реальных платежей. Для тестирования используйте тестовые данные карт, которые можно найти в документации YooKassa.
- Создайте тестовый заказ в вашем Telegram-магазине
- Выберите оплату картой и используйте тестовые данные карты
- Проверьте, что денежные средства зачислены на ваш баланс в YooKassa (в тестовом режиме средства не списываются реально)
- Убедитесь, что статус оплаты заказа в YooKassa изменился на "Оплачен"
- Проверьте в административной панели YWI в разделе "Заказы" — у заказа статус оплаты должен измениться на "Оплачен"
💡 Совет: После успешного тестирования переключите магазин в YooKassa на боевой режим, чтобы начать принимать реальные платежи. Комиссия YooKassa составляет от 2,8% за каждую транзакцию в зависимости от суммы и типа платежа.
📅 Сроки зачисления средств: После успешной оплаты деньги поступают на ваш баланс в YooKassa практически мгновенно. Вывод средств на ваш расчётный счёт обычно занимает от 1 до 3 рабочих дней в зависимости от тарифа и настроек вашего аккаунта.
🔒 Безопасность платежей
Все платежи обрабатываются через защищённый шлюз YooKassa с поддержкой PCI DSS. Данные карт ваших клиентов не хранятся на серверах YWI и полностью защищены.
Возможные проблемы и решения
Если оплата не работает:
- Проверьте правильность введённых Shop ID и Secret Key (убедитесь, что нет лишних пробелов при копировании)
- Убедитесь, что URL уведомлений корректно скопирован в YooKassa (должен начинаться с https://)
- Проверьте статус вашего магазина в YooKassa (должен быть активен и верифицирован)
- Убедитесь, что в YooKassa выбраны правильные события для уведомлений (payment.succeeded, payment.waiting_for_capture, payment.canceled)
- Проверьте логи в личном кабинете YooKassa — там можно увидеть детали ошибок при обработке платежей
- Свяжитесь с поддержкой YWI, если проблема не решена
Чеклист успешного подключения
Убедитесь, что вы выполнили все пункты:
- ✅ Зарегистрированы в YooKassa и создан магазин
- ✅ Заполнены Shop ID и Secret Key в модуле YooKassa в YWI
- ✅ Настроены HTTP уведомления в YooKassa с правильным URL
- ✅ Выбраны все необходимые события (payment.succeeded, payment.waiting_for_capture, payment.canceled)
- ✅ Добавлен способ оплаты в настройках оформления заказа в YWI
- ✅ Выбран модуль "yookassa" для типа оплаты
- ✅ Протестирована оплата тестовым заказом
Начните принимать платежи сегодня!
Подключив онлайн-оплату через YooKassa, вы сможете принимать платежи от клиентов со всего мира. Это значительно повысит конверсию вашего магазина и доверие покупателей.
Хотите создать свой маркетплейс в Telegram? Начните с бесплатного тарифа YWI (без ограничений по времени!) и запустите продажи уже сегодня!