Микросервис на Laravel для рассрочки платежей в интернет-магазине

Сервис «Долями» работает почти так же, как обычный платежный шлюз для обработки оплаты банковскими картами. Поскольку рассрочку предоставляет не магазин, а банк, даже фискальный чек создается по правилам обычной продажи. Единственное существенное отличие состоит в том, что банк может отказать клиенту в рассрочке, и такой отказ придет в систему в виде отдельного статуса заявки.

• http-запросы отправляет магазин, с их помощью он инициирует и подтверждает сделку.
  Банк сразу присылает ответ со статусом заявки и необходимыми для дальнейших действий данными;
• вебхуки присылает банк на специальный адрес, предоставляемый магазином. Это сообщения о ходе обработки запроса: одобрение или отказ заявки, успешное или неуспешное списание средств. Вебхуки необходимы, поскольку между запросом и конкретным действием проходит неопределенное количество времени: клиент заполняет форму, банк принимает решение о предоставлении рассрочки и т.д.

1. Когда клиент выбирает опцию «Оплатить долями», магазин отправляет в банк запрос на создание транзакции (API-метод Create). Запрос содержит уникальный идентификатор заказа, информацию о его составе и стоимости, имеющиеся данные клиента, а также три веб-адреса: страницы, куда сервис перенаправит клиента после успешной и неуспешной оплаты, а также ссылку, по которой придет http-нотификация после обработки запроса (вебхук).

2. В ответ на запрос сервис присылает ссылку на страницу ввода личных данных и оплаты; сайт перенаправляет клиента на нее. Таким образом, магазин не имеет доступа к личным данным клиента, всю информацию пользователь вводит на странице банка.

3. После того, как клиент введет необходимые данные, сервис последовательно пришлет два вебхука на предоставленный адрес для html-нотификации. Первый сообщит о том, что заявка клиента одобрена; второй – о том, что четверть стоимости заказа была захолдирована.

4. После получения второго вебхука магазин отправляет запрос на подтверждение транзакции (метод Commit).

1. Изучение технологического стека проекта

Проект магазина написан на связке Laravel и Vue, что дает возможность легкого расширения существующего функционала – компонентами фронтенда и API-микросервисами для бэкенда.

2. Выпуск сертификата.

Поскольку MTLS-сертификат необходим уже в первых тестовых запросах, создаваемых вручную, его необходимо выпустить в первую очередь. Делается это с помощью предоставляемой банком утилиты.

3. Разработка решения.

На первом этапе была продумана архитектура решения и написана его бета- версия, содержащая основные модули и обеспечивающая работу базового функционала.

• Основной API для работы с «Долями»: микросервис, принимающий заявки от клиентского приложения на инициацию платежа, контролирующий их статус и отправляющий запросы в банк.
• Внешний API для вебхуков: отдельный микросервис, принимающий уведомления от сервиса о движении заявки и передающий эту информацию в основной API.
• Новый функционал фронтенда: при добавлении товаров на определенную сумму в корзине появляется опция оплаты «Долями».
• Автотесты: проверка правильного функционирования логики в автоматическом режиме.

4. Рефакторинг.

Убедившись, что решение работает, мы собрали комментарии по коду от коллег, глубже изучили техническую документацию сервиса и особенности его работы, а также посмотрели, как реализованы готовые модули для его интеграции с CMS. После этого провели рефакторинг: повысили надежность кода и его читаемость для удобства доработок в будущем. Решение передается клиенту, у него должна быть возможность легко вносить изменения и новый функционал.

5. Тестирование.

Сервис «Долями» предоставляет тестовый контур для испытания написанного решения перед его внедрением.

Разработка решения продолжалась с марта по июнь 2023 года. Всего на нее ушло 165 человекочасов, включая работу фронтендеров и тестировщиков. Непосредственно разработка микросервисов бекенда осуществлялась в два этапа: базовая версия и ее интеграция с сайтом магазина заняла 45 часов, рефакторинг, тестирование и финальная интеграция – 52 часа. Такой небольшой срок разработки стал возможен благодаря использованию микросервисной архитектуры. Нам не пришлось ничего менять в коде бэкенда самого магазина, наши модули работают отдельно и подключаются к нему с помощью API.

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