Оплата
Как устроена абстракция платёжного шлюза и что нужно боевому провайдеру.
Честная версия
В ядре есть абстракция платёжного шлюза, а не встроенный провайдер.
App\Services\Payments\PaymentGateway контракт
App\Services\Payments\PaymentManager реестр шлюзов
App\Services\Payments\MockGateway то, что есть в свежей установке
Модуль регистрирует свой шлюз в сервис-провайдере, касса показывает всё, что зарегистрировано. Деньги в любом случае идут через ваш мерчант-аккаунт и вашего провайдера, а ядро не знает, какого именно.
Что есть в свежей установке
Только мок-шлюз. Он помечает заказ оплаченным, выпускает билеты и пропускает редирект на платёжную страницу. Именно его использует демо, и его хватает, чтобы отрепетировать весь путь: удержание места, заказ, билеты, PDF.
Деньги он не двигает, и показывать его покупателям на боевом сайте нельзя.
Подключение боевого провайдера
Боевой провайдер — это модуль. При установке к вашему мерчант-аккаунту подключается один из них:
- Robokassa — карты, СБП и кошельки для рублёвых платежей.
- Stripe — международные карты.
Провайдер выдаёт идентификатор магазина, пароль и алгоритм подписи. Они попадают в настройки модуля, а не в код.
Путь подтверждения
Именно эта часть решает, потеряете вы деньги или нет, поэтому её стоит прочитать, даже если настройкой занимается кто-то другой.
- Сайт создаёт заказ со статусом pending и удерживает выбранные места на один час.
- Покупатель уходит к провайдеру.
- Провайдер вызывает ваш Result URL со своего сервера, с подписью.
- Сайт проверяет подпись, сверяет сумму с заказом и только потом помечает его оплаченным.
- Выпускаются билеты с QR. Если то же уведомление приходит второй раз, оно находит заказ уже оплаченным и ничего не делает.
Success URL, куда возвращается покупатель, — косметика: вкладку можно закрыть, и заказ всё равно подтвердится серверным колбэком. Покупатель может и подделать страницу успеха, поэтому там ничего не выпускается.
Сначала песочница
У каждого провайдера есть тестовый режим. Прогоните в нём хотя бы одну полную покупку — включая намеренно неудачный платёж и повторное уведомление — прежде чем включать боевые доступы.
Возвраты
Возвраты делаются в панели провайдера. Админка фиксирует смену статуса заказа, но не вызывает API возвратов: для этого нужны права, которые большинство магазинов сайту не выдаёт.
Если заказ завис в pending
Проверяйте по порядку: Result URL в панели провайдера, его собственный журнал уведомлений и storage/logs/laravel.log. Неверный Result URL — самая частая причина: покупатель платит, сайт об этом не узнаёт, через час места освобождаются.
Не нашли ответ?
Напишите на sales@scenecms.ru — отвечаем в течение рабочего дня.