Documentation

Система Оплаты Членства - Полная 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
- Должен быть публично доступен
Тестирование с песочницей
Используйте тестовые учетные данные для разработки:

Реализация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Интеграция Платежей 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
- Должен быть публично доступен
Тестирование с песочницей
Используйте тестовые учетные данные для разработки:

Реализация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Интеграция Платежей 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
- Должен быть публично доступен
Тестирование с песочницей
Используйте тестовые учетные данные для разработки:

Реализация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

text


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

text


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

text


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