Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    1. Документация
    2. /Функции
    3. /Интеграция WayForPay

    3 мин прослушивания

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Интеграция WayForPay

    3 мин прослушивания

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Интеграция WayForPay

    3 мин прослушивания

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Интеграция Платежей WayForPay

    Система Оплаты Членства - Полная PCI-DSS совместимая платежная система для обновления ПОДПИСЧИК→УЧАСТНИК с автоматическим управлением ролями и обработкой вебхуков.

    Ring Platform интегрирует платежный шлюз WayForPay для обеспечения безопасного обновления членства, автоматически повышая роль пользователя с ПОДПИСЧИК до УЧАСТНИК после успешной оплаты.

    Обзор

    Что такое WayForPay?

    WayForPay — ведущий украинский платежный шлюз с поддержкой:

    • 💳 Банковские карты (Visa, MasterCard)
    • 📱 Цифровые кошельки (Apple Pay, Google Pay)
    • 🏦 Украинские банки (Privat24, LiqPay)
    • 📅 Рассрочки (PayParts, мгновенные рассрочки)
    • 💱 Мультивалютная поддержка (UAH, USD, EUR)

    Архитектура Платежей

    Настройка

    Переменные Окружения

    Критично для безопасности: Никогда не раскрывайте WAYFORPAY_SECRET_KEY в клиентском коде. Вся генерация подписей должна происходить на сервере.

    Добавьте в ваш .env.local:

    Интеграция платежей WayForPay URL приложения (для обратных вызовов)

    Получение Учетных Данных

    1. 1

      Создайте аккаунт WayForPay

      1. Посетите wayforpay.com
      2. Зарегистрируйтесь как мерчант
      3. Завершите KYC верификацию
      4. Перейдите в Настройки → API
      5. Скопируйте аккаунт мерчанта и секретный ключ
    2. 2

      Настройте URL вебхука

      В панели WayForPay:

      • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
      • Должен быть HTTPS
      • Должен быть публично доступен
    3. 3

      Тестирование с песочницей

      Используйте тестовые учетные данные для разработки:

    Реализация

    Уровень Сервиса

    Сервис WayForPay (lib/payments/wayforpay-service.ts) предоставляет три основные функции:

    1. Инициация Платежа

    2. Обработка Вебхука

    Настройка Цен

    Текущие цены членства:

    Безопасность

    Проверка HMAC-MD5 Подписи

    Требование Безопасности: Все вебхуки ДОЛЖНЫ проверять HMAC-MD5 подписи перед обработкой. Это предотвращает несанкционированные обновления ролей и платежное мошенничество.

    Генерация подписи:

    Соответствие PCI-DSS

    Ring Platform поддерживает соответствие PCI-DSS через:

    ✅ Хостинг Платежной Страницы: Данные карт не касаются вашего сервера
    ✅ Без Хранения Карт: Никогда не храните полные номера карт или CVV
    ✅ Только HTTPS: Вся коммуникация зашифрована
    ✅ Валидация Подписи: Каждый вебхук проверен
    ✅ Аудит: Полное логирование истории платежей

    Система Обновления Ролей

    При успешной оплате система автоматически:

    1. Проверяет подпись вебхука
    2. Валидирует статус транзакции
    3. Извлекает ID пользователя из референса заказа
    4. Обновляет роль пользователя в базе данных
    5. Записывает метаданные платежа
    6. Логирует событие обновления

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

    Тестовая Среда

    WayForPay предоставляет песочницу с тестовыми картами для интеграционного тестирования.

    Тестовые Учетные Данные:

    Тестовые Карты:

    Контрольный Список Продакшена

    1. 1

      Перед Запуском

      • Настроены учетные данные продакшена
      • URL вебхука установлен на HTTPS точку продакшена
      • Переменные окружения защищены
      • Проверка подписи протестирована
      • Платежный поток протестирован от начала до конца
      • Страницы успеха/неудачи проверены
      • Логирование полное
      • Обработка ошибок завершена
    2. 2

      День Запуска

      • Мониторить первые транзакции внимательно
      • Проверить вебхуки получены и обработаны
      • Проверить обновления ролей успешны
      • Мониторить ошибки валидации подписи
      • Отслеживать уровень успеха платежей
      • Иметь команду поддержки готовой

    Следующие Шаги

    Интеграция WayForPay завершена! Теперь вы можете:

    • ✅ Принимать обновления членства за ₴299 UAH
    • ✅ Автоматически обновлять ПОДПИСЧИК→УЧАСТНИК
    • ✅ Отслеживать историю платежей и аналитику
    • ✅ Обрабатывать успех и неудачи корректно
    • ✅ Генерировать доход от уровней членства

    Нужна помощь с интеграцией платежей? Консультируйтесь с WayForPay Integrator Specialist (Legiox Agent #124) для экспертного руководства по обработке платежей, лучших практик безопасности и оптимизации дохода.

    Интеграция Платежей WayForPay

    Система Оплаты Членства - Полная PCI-DSS совместимая платежная система для обновления ПОДПИСЧИК→УЧАСТНИК с автоматическим управлением ролями и обработкой вебхуков.

    Ring Platform интегрирует платежный шлюз WayForPay для обеспечения безопасного обновления членства, автоматически повышая роль пользователя с ПОДПИСЧИК до УЧАСТНИК после успешной оплаты.

    Обзор

    Что такое WayForPay?

    WayForPay — ведущий украинский платежный шлюз с поддержкой:

    • 💳 Банковские карты (Visa, MasterCard)
    • 📱 Цифровые кошельки (Apple Pay, Google Pay)
    • 🏦 Украинские банки (Privat24, LiqPay)
    • 📅 Рассрочки (PayParts, мгновенные рассрочки)
    • 💱 Мультивалютная поддержка (UAH, USD, EUR)

    Архитектура Платежей

    Настройка

    Переменные Окружения

    Критично для безопасности: Никогда не раскрывайте WAYFORPAY_SECRET_KEY в клиентском коде. Вся генерация подписей должна происходить на сервере.

    Добавьте в ваш .env.local:

    Интеграция платежей WayForPay URL приложения (для обратных вызовов)

    Получение Учетных Данных

    1. 1

      Создайте аккаунт WayForPay

      1. Посетите wayforpay.com
      2. Зарегистрируйтесь как мерчант
      3. Завершите KYC верификацию
      4. Перейдите в Настройки → API
      5. Скопируйте аккаунт мерчанта и секретный ключ
    2. 2

      Настройте URL вебхука

      В панели WayForPay:

      • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
      • Должен быть HTTPS
      • Должен быть публично доступен
    3. 3

      Тестирование с песочницей

      Используйте тестовые учетные данные для разработки:

    Реализация

    Уровень Сервиса

    Сервис WayForPay (lib/payments/wayforpay-service.ts) предоставляет три основные функции:

    1. Инициация Платежа

    2. Обработка Вебхука

    Настройка Цен

    Текущие цены членства:

    Безопасность

    Проверка HMAC-MD5 Подписи

    Требование Безопасности: Все вебхуки ДОЛЖНЫ проверять HMAC-MD5 подписи перед обработкой. Это предотвращает несанкционированные обновления ролей и платежное мошенничество.

    Генерация подписи:

    Соответствие PCI-DSS

    Ring Platform поддерживает соответствие PCI-DSS через:

    ✅ Хостинг Платежной Страницы: Данные карт не касаются вашего сервера
    ✅ Без Хранения Карт: Никогда не храните полные номера карт или CVV
    ✅ Только HTTPS: Вся коммуникация зашифрована
    ✅ Валидация Подписи: Каждый вебхук проверен
    ✅ Аудит: Полное логирование истории платежей

    Система Обновления Ролей

    При успешной оплате система автоматически:

    1. Проверяет подпись вебхука
    2. Валидирует статус транзакции
    3. Извлекает ID пользователя из референса заказа
    4. Обновляет роль пользователя в базе данных
    5. Записывает метаданные платежа
    6. Логирует событие обновления

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

    Тестовая Среда

    WayForPay предоставляет песочницу с тестовыми картами для интеграционного тестирования.

    Тестовые Учетные Данные:

    Тестовые Карты:

    Контрольный Список Продакшена

    1. 1

      Перед Запуском

      • Настроены учетные данные продакшена
      • URL вебхука установлен на HTTPS точку продакшена
      • Переменные окружения защищены
      • Проверка подписи протестирована
      • Платежный поток протестирован от начала до конца
      • Страницы успеха/неудачи проверены
      • Логирование полное
      • Обработка ошибок завершена
    2. 2

      День Запуска

      • Мониторить первые транзакции внимательно
      • Проверить вебхуки получены и обработаны
      • Проверить обновления ролей успешны
      • Мониторить ошибки валидации подписи
      • Отслеживать уровень успеха платежей
      • Иметь команду поддержки готовой

    Следующие Шаги

    Интеграция WayForPay завершена! Теперь вы можете:

    • ✅ Принимать обновления членства за ₴299 UAH
    • ✅ Автоматически обновлять ПОДПИСЧИК→УЧАСТНИК
    • ✅ Отслеживать историю платежей и аналитику
    • ✅ Обрабатывать успех и неудачи корректно
    • ✅ Генерировать доход от уровней членства

    Нужна помощь с интеграцией платежей? Консультируйтесь с WayForPay Integrator Specialist (Legiox Agent #124) для экспертного руководства по обработке платежей, лучших практик безопасности и оптимизации дохода.

    Интеграция Платежей WayForPay

    Система Оплаты Членства - Полная PCI-DSS совместимая платежная система для обновления ПОДПИСЧИК→УЧАСТНИК с автоматическим управлением ролями и обработкой вебхуков.

    Ring Platform интегрирует платежный шлюз WayForPay для обеспечения безопасного обновления членства, автоматически повышая роль пользователя с ПОДПИСЧИК до УЧАСТНИК после успешной оплаты.

    Обзор

    Что такое WayForPay?

    WayForPay — ведущий украинский платежный шлюз с поддержкой:

    • 💳 Банковские карты (Visa, MasterCard)
    • 📱 Цифровые кошельки (Apple Pay, Google Pay)
    • 🏦 Украинские банки (Privat24, LiqPay)
    • 📅 Рассрочки (PayParts, мгновенные рассрочки)
    • 💱 Мультивалютная поддержка (UAH, USD, EUR)

    Архитектура Платежей

    Настройка

    Переменные Окружения

    Критично для безопасности: Никогда не раскрывайте WAYFORPAY_SECRET_KEY в клиентском коде. Вся генерация подписей должна происходить на сервере.

    Добавьте в ваш .env.local:

    Интеграция платежей WayForPay URL приложения (для обратных вызовов)

    Получение Учетных Данных

    1. 1

      Создайте аккаунт WayForPay

      1. Посетите wayforpay.com
      2. Зарегистрируйтесь как мерчант
      3. Завершите KYC верификацию
      4. Перейдите в Настройки → API
      5. Скопируйте аккаунт мерчанта и секретный ключ
    2. 2

      Настройте URL вебхука

      В панели WayForPay:

      • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
      • Должен быть HTTPS
      • Должен быть публично доступен
    3. 3

      Тестирование с песочницей

      Используйте тестовые учетные данные для разработки:

    Реализация

    Уровень Сервиса

    Сервис WayForPay (lib/payments/wayforpay-service.ts) предоставляет три основные функции:

    1. Инициация Платежа

    2. Обработка Вебхука

    Настройка Цен

    Текущие цены членства:

    Безопасность

    Проверка HMAC-MD5 Подписи

    Требование Безопасности: Все вебхуки ДОЛЖНЫ проверять HMAC-MD5 подписи перед обработкой. Это предотвращает несанкционированные обновления ролей и платежное мошенничество.

    Генерация подписи:

    Соответствие PCI-DSS

    Ring Platform поддерживает соответствие PCI-DSS через:

    ✅ Хостинг Платежной Страницы: Данные карт не касаются вашего сервера
    ✅ Без Хранения Карт: Никогда не храните полные номера карт или CVV
    ✅ Только HTTPS: Вся коммуникация зашифрована
    ✅ Валидация Подписи: Каждый вебхук проверен
    ✅ Аудит: Полное логирование истории платежей

    Система Обновления Ролей

    При успешной оплате система автоматически:

    1. Проверяет подпись вебхука
    2. Валидирует статус транзакции
    3. Извлекает ID пользователя из референса заказа
    4. Обновляет роль пользователя в базе данных
    5. Записывает метаданные платежа
    6. Логирует событие обновления

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

    Тестовая Среда

    WayForPay предоставляет песочницу с тестовыми картами для интеграционного тестирования.

    Тестовые Учетные Данные:

    Тестовые Карты:

    Контрольный Список Продакшена

    1. 1

      Перед Запуском

      • Настроены учетные данные продакшена
      • URL вебхука установлен на HTTPS точку продакшена
      • Переменные окружения защищены
      • Проверка подписи протестирована
      • Платежный поток протестирован от начала до конца
      • Страницы успеха/неудачи проверены
      • Логирование полное
      • Обработка ошибок завершена
    2. 2

      День Запуска

      • Мониторить первые транзакции внимательно
      • Проверить вебхуки получены и обработаны
      • Проверить обновления ролей успешны
      • Мониторить ошибки валидации подписи
      • Отслеживать уровень успеха платежей
      • Иметь команду поддержки готовой

    Следующие Шаги

    Интеграция WayForPay завершена! Теперь вы можете:

    • ✅ Принимать обновления членства за ₴299 UAH
    • ✅ Автоматически обновлять ПОДПИСЧИК→УЧАСТНИК
    • ✅ Отслеживать историю платежей и аналитику
    • ✅ Обрабатывать успех и неудачи корректно
    • ✅ Генерировать доход от уровней членства

    Нужна помощь с интеграцией платежей? Консультируйтесь с WayForPay Integrator Specialist (Legiox Agent #124) для экспертного руководства по обработке платежей, лучших практик безопасности и оптимизации дохода.

    text
    
    Visa (Успех):       4111111111111111
    Visa (Отклонено):   4000000000000002
    MasterCard (Успех): 5555555555554444
    text
    
    Visa (Успех):       4111111111111111
    Visa (Отклонено):   4000000000000002
    MasterCard (Успех): 5555555555554444
    text
    
    Visa (Успех):       4111111111111111
    Visa (Отклонено):   4000000000000002
    MasterCard (Успех): 5555555555554444