Платёжное ядро

Логику оплаты переписывали под каждый продукт и путали с его фреймворком и базой — именно там и прячутся платёжные баги.

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

Чистое TypeScript-ядро с доменными правилами оплаты без импортов фреймворка или БД; каждый литовский банк или PSP это тонкий провайдер-адаптер, а ядро усилено там, где деньги реально ломаются: проверки подписи и свежести webhook, защита от переполнения суммы и лишних знаков, валидация redirect-целей и потоки ручной проверки, когда ссылка или сумма из callback не совпадают.

Это пакет на TypeScript, содержащий только правила платёжной предметной области — подпись запросов, валидацию колбэков, нормализацию статусов, проверки суммы и валюты, обработку повторных колбэков и безопасные для аудита нормализованные события. Ядро не импортирует никакого фреймворка, HTTP-рантайма или клиента базы данных: оно принимает простую структуру PaymentHttpRequest, так что один и тот же код провайдеров работает из нашего реактивного бэкенда, Node-воркеров или тестов. Реализовано несколько реальных литовских банков и провайдеров; банки без официальных мерчант-материалов поставляются как строгие скелеты, которые бросают ошибку, а не гадают.

Сделано на TypeScript, Bank integrations, Crypto.

Чистый TypeScript с подключаемыми адаптерами Web Crypto и Node crypto, без импортов фреймворка в точке входа ядра, и CI-гейт, удерживающий 100% покрытие по операторам, ветвям, функциям и строкам в рантайм-коде.

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

Один и тот же код провайдеров работает без изменений на разных бэкендах и в тестах, а каждый путь, завершающий платёж, ломается безопасно — переполненная сумма, повторный колбэк или несовпадающая ссылка выдают отсутствие платежа или флаг проверки, а не неверный результат.