Перейти к содержимому
SceneCMS

Оплата

Как устроена абстракция платёжного шлюза и что нужно боевому провайдеру.

Честная версия

В ядре есть абстракция платёжного шлюза, а не встроенный провайдер.

App\Services\Payments\PaymentGateway      контракт
App\Services\Payments\PaymentManager      реестр шлюзов
App\Services\Payments\MockGateway         то, что есть в свежей установке

Модуль регистрирует свой шлюз в сервис-провайдере, касса показывает всё, что зарегистрировано. Деньги в любом случае идут через ваш мерчант-аккаунт и вашего провайдера, а ядро не знает, какого именно.

Что есть в свежей установке

Только мок-шлюз. Он помечает заказ оплаченным, выпускает билеты и пропускает редирект на платёжную страницу. Именно его использует демо, и его хватает, чтобы отрепетировать весь путь: удержание места, заказ, билеты, PDF.

Деньги он не двигает, и показывать его покупателям на боевом сайте нельзя.

Подключение боевого провайдера

Боевой провайдер — это модуль. При установке к вашему мерчант-аккаунту подключается один из них:

  • Robokassa — карты, СБП и кошельки для рублёвых платежей.
  • Stripe — международные карты.

Провайдер выдаёт идентификатор магазина, пароль и алгоритм подписи. Они попадают в настройки модуля, а не в код.

Путь подтверждения

Именно эта часть решает, потеряете вы деньги или нет, поэтому её стоит прочитать, даже если настройкой занимается кто-то другой.

  1. Сайт создаёт заказ со статусом pending и удерживает выбранные места на один час.
  2. Покупатель уходит к провайдеру.
  3. Провайдер вызывает ваш Result URL со своего сервера, с подписью.
  4. Сайт проверяет подпись, сверяет сумму с заказом и только потом помечает его оплаченным.
  5. Выпускаются билеты с QR. Если то же уведомление приходит второй раз, оно находит заказ уже оплаченным и ничего не делает.

Success URL, куда возвращается покупатель, — косметика: вкладку можно закрыть, и заказ всё равно подтвердится серверным колбэком. Покупатель может и подделать страницу успеха, поэтому там ничего не выпускается.

Сначала песочница

У каждого провайдера есть тестовый режим. Прогоните в нём хотя бы одну полную покупку — включая намеренно неудачный платёж и повторное уведомление — прежде чем включать боевые доступы.

Возвраты

Возвраты делаются в панели провайдера. Админка фиксирует смену статуса заказа, но не вызывает API возвратов: для этого нужны права, которые большинство магазинов сайту не выдаёт.

Если заказ завис в pending

Проверяйте по порядку: Result URL в панели провайдера, его собственный журнал уведомлений и storage/logs/laravel.log. Неверный Result URL — самая частая причина: покупатель платит, сайт об этом не узнаёт, через час места освобождаются.

Не нашли ответ?

Напишите на sales@scenecms.ru — отвечаем в течение рабочего дня.

Контакты