Задача
Продукт начинался как агрегатор оплаты на готовой коробочной платформе. Через несколько лет стало ясно, что коробка кончилась: каждая новая валюта, каждый новый шлюз и каждое новое правило лимитов упирались в чужие решения, принятые до нас.
Нужен был полный перенос на собственную платформу, причём без остановки сервиса и без потери поисковых адресов, накопленных за годы.
Решение
Кошелёк переписан целиком, а старая система оставлена как справочник по протоколам платёжных партнёров. Это сэкономило месяцы: документация у платёжных API редко описывает то, что происходит в реальности.
В основе лежит правило, от которого не отступали ни разу. Любая денежная операция выполняется функцией внутри базы данных, а не кодом приложения. База сама обеспечивает атомарность, и двойное списание перестаёт быть вопросом аккуратности программиста.
Второе правило того же ряда — деньги в коде никогда не считаются числами с плавающей точкой. Только десятичная арифметика.
Архитектура и реализация
Состав системы:
· приём и вывод средств через процессинговые шлюзы
· оплата услуг через агрегаторы, отдельный реестр от шлюзов приёма
· мультивалютный баланс
· проверка личности и уровни лимитов
· реферальная механика
· очереди фоновых задач для медленных операций с партнёрами
· API, из которого одинаково работают сайт и будущее мобильное приложение
Стек: NestJS и TypeScript на сервере, Next.js в кабинете, PostgreSQL с функциями расчёта, Redis с очередями.
Результат
Продукту почти десять лет, и он продолжает обслуживать платежи людей, которые живут в одной стране, а платят в другой. Это самый долгоживущий из наших платёжных сервисов, и он же самый показательный: за десять лет через такую систему проходит всё, что вообще может произойти с деньгами в пути.
