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

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

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

Сервис BNPL (Buy Now Pay Later) «Долями» от банка «Тинькофф» предлагает такую возможность. По условиям банка сразу после оформления покупки списывается четверть суммы покупки, а затем каждые две недели с карты клиента списывается еще по 25%. Магазин же сразу получает деньги за товар за вычетом процента банка.

У сервиса есть несколько готовых модулей для интеграции с популярными CMS-системами, такими, как «Битрикс», OpenCart, Tilda и другими. Сайт заказчика представляет собой собственную разработку на PHP (фреймворк Laravel), наше решение должно было интегрироваться именно с ней. Готовые модули от «Тинькофф» достаточно глубоко интегрированы с соответствующими CMS, их переписывание заняло бы больше времени, чем разработка своих микросервисов. К счастью, техническая документация «Долями» достаточно подробно описывает возможность подключения сервиса с помощью API.

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

Как и в случае платежного шлюза, обмен данными между магазином и банком осуществляется с помощью http-запросов и вебхуков:

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

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

Алгоритм работы системы в случае успешной покупки выглядит так:

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

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

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

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

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

Работа по подключению «Долями» была разбита на несколько этапов:

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

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

— выпуск сертификата

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

— разработка решения

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

1. Основной API для работы с «Долями»: микросервис, принимающий заявки от клиентского приложения на инициацию платежа, контролирующий их статус и отправляющий запросы в банк.

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

3. Новый функционал фронтенда: при добавлении товаров на определенную сумму в корзине появляется опция оплаты «Долями».

4. Автотесты: проверка правильного функционирования логики в автоматическом режиме:

— рефакторинг

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

— тестирование

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

Первое тестирование проводилось разработчиком. Оно не заменяет полноценного, но позволяет выявить основные проблемы кода и убедиться в базовой работоспособности. Выяснилось, что тестовый контур «Долями» не всегда работает в соответствии с документацией, некоторые моменты пришлось уточнять у техподдержки. Также были выявлены и исправлены баги интерфейса на фронтенде.

Второе тестирование проводил тестировщик на тестовом контуре. Здесь отрабатываются и документируются все возможные сценарии взаимодействия с решением.

Наконец, финальное тестирование было проведено уже после переноса решения на боевой контур «Долями». Здесь важно было убедиться, что оплаты верно отображаются в панели управления, а денежные средства поступают в нужном объеме на указанные счета.

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

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

Стоит учитывать, что за пользование сервиса платит бизнес – от 4.9% от суммы покупки. Такая комиссия может быть нерентабельной для магазинов с низкой маржой. Кроме того, формат рассрочки и график ее погашения формирует банк.

Мы считаем, что использование сервиса «Долями» может быть целесообразно для значительного количества интернет-магазинов, поскольку увеличивает продажи и снижает количество брошенных корзин. Рассрочка помогает клиенту решиться на покупку прямо сейчас, при этом магазин сразу получает денежные средства. Сервис позволяет не вкладываться в разработку отдельных решений для реализации программ по кредитованию покупателей, а его внедрение может быть проведено достаточно быстро даже в случае, когда магазин не использует одну из поддерживаемых CMS.