Ключи ЮKassa
Где взять shopId и секретный ключ, как включить уведомления и «Чеки от ЮKassa».
Ключи нужны модулю Онлайн-оплата: по ним сайт принимает платежи на ваш счёт в ЮKassa.
Получить shopId#
- Войдите в кабинет ЮKassa и выберите магазин вверху страницы.
- Откройте «Настройки» → «Магазин».
- Скопируйте число из поля «shopId».
Получить секретный ключ#
- В кабинете откройте «Интеграция» → «Ключи API».
- В блоке «Секретный ключ» нажмите «Выпустить ключ».
- Нажмите «Получить пароль» и введите код из SMS.
- Снова нажмите «Выпустить ключ» и скопируйте ключ. Он показывается один раз.
Потеряли ключ — выпустите новый. После перевыпуска старый ключ работает ещё 48 часов.
Подключить в панели#
Откройте «Онлайн-оплата», вставьте shopId и ключ, нажмите «Подключить». Появится «Подключено» и номер магазина.
Включить уведомления#
- В панели скопируйте адрес в блоке «Уведомления».
- В кабинете ЮKassa откройте «Интеграция» → «HTTP-уведомления».
- Вставьте адрес, отметьте «payment.succeeded», «payment.canceled» и «refund.succeeded», сохраните.
Адрес должен начинаться с https. Если уведомления не доходят, оплата всё равно засчитается, но с задержкой.
Включить «Чеки от ЮKassa»#
Чеки подключают при подключении магазина, в разделе «Чеки». Магазин уже подключён — напишите менеджеру ЮKassa. Проверить можно в «Настройки» → «Чеки от ЮKassa».
Чеки от ЮKassa доступны ИП и организациям. Самозанятому они не нужны: укажите «Самозанятый» в «Данных продавца» (раздел «Кто продаёт» в настройках магазина).
Тестовый магазин#
Чтобы проверить оплату без денег, создайте тестовый магазин. Договор не нужен. Ключ в нём выпущен заранее и начинается с test_. Для проверки подойдёт карта 5555 5555 5555 4477 с любым будущим сроком и любым CVC. Чеки в тестовом магазине не выбиваются, а способ «Онлайн» видите только вы.
Частые ошибки#
| Что видите | Что сделать |
|---|---|
| «ЮKassa не принимает ключ» | Проверьте shopId и ключ. Ключ от другого магазина не подойдёт. Выпустите новый |
| «Чеки не включены в ЮKassa» | Включите «Чеки от ЮKassa» по шагам выше |
| «Магазин в ЮKassa не активен» | Завершите подключение магазина в кабинете ЮKassa |
| «ЮKassa не отвечает» | Подождите минуту и нажмите «Проверить подключение» |
| «Нужен адрес сайта с https» | Подключите сертификат и укажите адрес сайта с https |
| Не включается «Показывать покупателям» | Причина написана рядом с переключателем |
Комиссия ЮKassa — по вашему договору, обычно процент с платежа. Zenix комиссию не берёт.
Не нашли ответ?
Напишите нам — ответим и поможем настроить.