ЮKassa для MiniShop3

Покупатель оформляет заказ, переходит на страницу ЮKassa и платит удобным способом. После оплаты статус заказа меняет сам MiniShop3, поэтому письма и другие обработчики срабатывают как обычно.

Бета-готовность: пакет проверен на MiniShop3 с имитацией API ЮKassa. Перед приёмом денег проведите оплату и возврат через тестовый магазин ЮKassa.

Что умеет

• Оплата: одностадийная, с переходом на страницу ЮKassa. Двухстадийной оплаты (холд) нет.
• Уведомления: payment.succeeded, payment.waiting_for_capture, payment.canceled, refund.succeeded.
• Возвраты: полный и частичный из вкладки заказа. Возврат из кабинета ЮKassa тоже попадёт в заказ.
• Чеки 54-ФЗ: при оплате и возврате, если у покупателя есть email. Частичный возврат идёт в чеке одной строкой на сумму возврата.
• Тестовый режим: включён по умолчанию, использует данные отдельного тестового магазина.

Как проверяются уведомления

У ЮKassa нет подписи уведомлений. Поэтому пакет не верит телу запроса: он запрашивает платёж или возврат в API ЮKassa ключом магазина и сверяет статус, сумму, валюту и заказ. Поддельное уведомление получает ответ 401 и ничего не меняет.

Настройка

1. В MiniShop3 откройте способ оплаты «ЮKassa» и заполните свойства: shop_id и secret_key боевого магазина, test_shop_id и test_secret_key тестового, test_mode.
2. В кабинете ЮKassa в разделе HTTP-уведомлений укажите адрес https://ВАШ_САЙТ/assets/components/msp3gtsyookassa/webhook.php и включите четыре события из списка выше.
3. Привяжите способ оплаты к доставке и включите его. После установки он выключен, чтобы ненастроенная оплата не появилась на витрине.
4. Проверьте оплату через тестовый магазин, затем выключите test_mode.

Сайт должен быть доступен из интернета по HTTPS, иначе уведомления не дойдут.

Требования

Лицензия

GNU GPL v2 или новее. Сделан на основе msp3PaymentSkeleton.