Оплата через ЮKassa

Полка создаёт платежи в вашей кассе ЮKassa: деньги идут напрямую вам, чек выдаёт ваша касса, комиссии Полки нет. Если кассы нет, заказы приходят в статусе «Новый», и об оплате вы договариваетесь с покупателем сами.

Что нужно

Аккаунт в ЮKassa с подключённым магазином. ЮKassa работает с самозанятыми, ИП и компаниями. Подключение занимает один-два дня со стороны ЮKassa.

Шаг 1. Возьмите ключи

В личном кабинете ЮKassa откройте «Интеграция» → «Ключи API». Там указан shopId (число) и можно выпустить секретный ключ (начинается с live_). Ключ показывается один раз — скопируйте его.

Шаг 2. Подключите кассу в Полке

В чате: «Подключить ЮKassa» → «Ввести shopId и ключ». В приложении: «Оплата» → «Подключить ЮKassa». Полка проверит ключи запросом к ЮKassa и сохранит их в зашифрованном виде. После этого новые заказы будут сразу получать ссылку на оплату.

Шаг 3. Настройте уведомления (рекомендуется)

Чтобы заказы отмечались оплаченными мгновенно, в кабинете ЮKassa откройте «Интеграция» → «HTTP-уведомления», вставьте адрес из приложения (он выглядит как https://polka-max.ru/yookassa/webhook/…) и отметьте события payment.succeeded и payment.canceled. Без уведомлений статус тоже проверится, но позже.

Чеки

Если в ЮKassa включена фискализация (для самозанятых — через «Мой налог»), Полка передаёт состав заказа и телефон покупателя, и касса формирует чек сама. Если фискализация не настроена, платёж проходит без чека, а чек вы выдаёте по своим правилам.

Безопасность

Секретный ключ хранится только в зашифрованном виде, не показывается в интерфейсе и используется исключительно для создания платежей по заказам вашего магазина и проверки их статуса. Отключить кассу можно в любой момент кнопкой «Отключить кассу»; ключ при этом удаляется. Если сомневаетесь, выпустите в ЮKassa новый ключ — старый перестанет работать.