Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom
    Proxy и интернационализация
    Real Time
    Security

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)
    Web3 Кошелек
    Store
    Ring ERP

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс
    Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс
    Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс

    Интеграция Платежей 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

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

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

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

    В панели WayForPay:

    • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
    • Должен быть HTTPS
    • Должен быть публично доступен
    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 предоставляет песочницу с тестовыми картами для интеграционного тестирования.

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

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

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

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

    1

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

    • Настроены учетные данные продакшена
    • URL вебхука установлен на HTTPS точку продакшена
    • Переменные окружения защищены
    • Проверка подписи протестирована
    • Платежный поток протестирован от начала до конца
    • Страницы успеха/неудачи проверены
    • Логирование полное
    • Обработка ошибок завершена
    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

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

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

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

    В панели WayForPay:

    • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
    • Должен быть HTTPS
    • Должен быть публично доступен
    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 предоставляет песочницу с тестовыми картами для интеграционного тестирования.

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

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

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

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

    1

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

    • Настроены учетные данные продакшена
    • URL вебхука установлен на HTTPS точку продакшена
    • Переменные окружения защищены
    • Проверка подписи протестирована
    • Платежный поток протестирован от начала до конца
    • Страницы успеха/неудачи проверены
    • Логирование полное
    • Обработка ошибок завершена
    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

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

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

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

    В панели WayForPay:

    • URL сервиса: https://ваш-домен.com/api/payments/wayforpay/webhook
    • Должен быть HTTPS
    • Должен быть публично доступен
    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 предоставляет песочницу с тестовыми картами для интеграционного тестирования.

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

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

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

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

    1

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

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

    День Запуска

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

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

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

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

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

    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Proxy и интернационализация
    Real Time
    Security
    Web3 Кошелек
    Store
    Ring ERP
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Proxy и интернационализация
    Real Time
    Security
    Web3 Кошелек
    Store
    Ring ERP
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Назад
    Назад
    Назад