PAY.ZNN — единый платёжный шлюз продуктовой экосистемы: одно API, оплата по коду, панель оператора.

Зачем единый шлюз

PAY.ZNN — внутренний платёжный шлюз, который сводит приём и учёт для всех текущих и будущих продуктов ZNN. Go + Gin — вебхуки и пропускная способность; Next.js — платёжный UX и панель оператора.

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

Архитектура

Проекты бьют в API PAY.ZNN → менеджер инвойсов и сессий → коннекторы провайдеров с идемпотентными вебхуками → event store и единые статусы → дашборд оператора и публичные страницы оплаты по коду.

• API-шлюз — создание инвойсов, сессии, исходящие уведомления
• Коннекторы провайдеров — нормализованные статусы, ошибки, политики ретраев
• Жизненный цикл инвойса — created, pending, paid, failed, expired с TTL и продлениями
• Event store — полный аудит-трейл для инцидентов и аналитики
• Панель оператора — поиск, фильтры, ручные действия, финансовые выгрузки

Оплата по коду

Клиент получает код инвойса (QR поддерживается), попадает на страницу оплаты с суммой, валютой, описанием и методами, платит и смотрит, как статус обновляется по мере прихода вебхуков провайдера — обрабатываются идемпотентно.

Безопасность и надёжность

Проверка подлинности вебхуков и защита от replay. Минимум чувствительных данных в хранении. RBAC в панели с аудитом действий. Идемпотентные create/update. Метрики латентности и ошибок провайдеров с алертами.

Интеграция в продукты

Быстрый старт: создать инвойс, вернуть код/ссылку. Глубокая интеграция: встроить общие платёжные компоненты. Централизованные уведомления о статусе держат продуктовые системы в синхроне без самописных обработчиков вебхуков на каждый проект.

Итог

PAY.ZNN стандартизирует платежи по экосистеме ZNN — одно API, единые статусы, видимость для оператора. Новые проекты стартуют быстрее, риск интеграции ниже, платёжная инфраструктура предсказуема и масштабируется.