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) для експертного керівництва по обробці платежів, найкращих практик безпеки та оптимізації доходу.

Інтеграція Платежів 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) для експертного керівництва по обробці платежів, найкращих практик безпеки та оптимізації доходу.

Інтеграція Платежів 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) для експертного керівництва по обробці платежів, найкращих практик безпеки та оптимізації доходу.

text


Visa (Успіх):      4111111111111111
Visa (Відхилено):  4000000000000002
MasterCard (Успіх): 5555555555554444

text


Visa (Успіх):      4111111111111111
Visa (Відхилено):  4000000000000002
MasterCard (Успіх): 5555555555554444

text


Visa (Успіх):      4111111111111111
Visa (Відхилено):  4000000000000002
MasterCard (Успіх): 5555555555554444