- Швидка реєстрація та підтвердження мерчанта
- Реєстрація мерчанта для фізичних осіб без вебсайту
- Єдиний відсоток для фізичних та юридичних осіб – 2.5%
- Наявність Google Play та ApplePay
Як підключити
Для підключення платіжної системи wayforpay вам знадобляться 3 значення:
- логін мерчанта
- секретний ключ мерчанта
- доменне ім'я вебсайту мерчанта.
Перейдіть до особистого кабінету -> налаштування магазину https://m.wayforpay.com/mportal/merchant/list
Скопіюйте дані та перейдіть до налаштувань у Mavibot.
Відкрийте розділ "Еквайринг", виберіть wayforpay.
Вам потрібно ввести отримані дані у формі, що відкриється:
Для генерації платіжного посилання потрібно встановити значення змінної payment_sum (наприклад, 150 або 100.55, якщо сума дробова, то сума відокремлюється крапкою):
Відразу після цього з'явиться змінна wayforpay_pay_url. Цю змінну можна відобразити в повідомленні з посиланням або розмістити на кнопці з текстом "Оплатити":
Варіант 1. Посилання на оплату в кнопці:
Варіант 2. Посилання на оплату в полі url вкладення:
Посилання виглядає так:
https://secure.wayforpay.com/invoice/id1bbb2ad0375
За замовчуванням встановлено USD (долари), якщо потрібна інша валюта, необхідно встановити значення змінної валюти.
Також перед встановленням значення змінної payment_sum ви можете встановити наступні необов'язкові змінні для налаштування платежу.
currency - валюта замовлення за замовчуванням, UAH (можливі значення USD, EUR, RUB)
session_timeout - час життя посилання в секундах, за замовчуванням 3600 (1 година)
product_name - назва товару
language - мова платіжної сторінки, за замовчуванням UA (можливі значення RU, EN)
buyer_name - ім'я покупця
buyer_email - електронна пошта покупця
buyer_first_name - ім'я покупця
buyer_last_name - прізвище покупця
Ось як виглядає платіжна сторінка з посиланням.
Створимо посилання для оплати на суму 1 USD з часом життя 2 години:
Зверніть увагу:
- Спочатку вкажіть необов'язкові параметри product_name тощо.
- І в останню чергу, призначте значення змінної payment_sum.
Зверніть увагу, що спочатку ми встановлюємо змінні для налаштувань, потім payment_sum. Змінні можна встановлювати раніше в ланцюжку, а не в одному блоці, це лише приклад.
Далі, в наступному блоці, ми виводимо змінну wayforpay_pay_url, яка містить посилання (наприклад, посилання в тексті):
Бот працюватиме наступним чином:
Як обробити результат
Після успішної оплати до бота будуть надіслані зворотні виклики, які повідомлять, що оплата пройшла успішно. Ви бачите ці зворотні виклики в системі як повідомлення від користувача, щоб користувач не міг їх надіслати, вони складаються з перших 10 символів секретного ключа та постскриптуму _success, наприклад: flk3409ref_success
Ці зворотні виклики НЕ ВИДНІ користувачеві, вони відображаються лише оператору.
Тип порівняння має бути "Повний збіг"
Також після успішної оплати змінна wayforpay_payment_completed встановлюється в True.
Наприклад, ви можете обробити успішну оплату в умовному блоці та відобразити відповідне повідомлення користувачеві:
Якщо ви не хочете вибивати клієнта з основної схеми чат-бота, використовуйте блок "Нестандартний стан з умовою". Ви не можете перейти до цього блоку, тому клієнт не буде вибитий з основної воронки після оплати та отримає сповіщення про успішну оплату.
А якщо вам потрібно продовжити воронку з реакцією на успішну оплату, використовуйте блок "Стартова умова", тоді клієнт перейде з платіжного блоку до блоку "Стартова умова", з якого ви зможете продовжити воронку.
Більше інформації про умовні блоки наведено в однойменній статті
Після завершення оплати до клієнта буде додано змінну wayforpay_callback_data, що містить дані відповіді платіжної системи на завершену транзакцію. Ви можете витягти необхідні дані з отриманого словника за допомогою методу get.
Функції для роботи з калькулятором
Для регулярних платежів
wayforpay_recurrent_payment(amount, currency, session_timeout, product_name, language, buyer_name, buyer_email, regular_date_next, regular_date_end, regular_count, regular_mode) - генерує посилання для регулярного платежу.
Скасування регулярного платежу
wayforpay_delete_recurrent() - скасовує майбутні автоматичні платежі клієнта. Повертає "Ok" при успішному виконанні.
Ви також можете використовувати блоки "Стартовий тригер" та "Стан" (у прикладі використовуються блоки "Нестандартний стан з умовою" та "Нестандартний стан").
Якщо ви не хочете видаляти клієнта з основного потоку чат-бота, використовуйте блок "Нестандартний стан з умовою" — цей блок не можна ввести вручну, тому клієнт залишиться в основній воронці після оплати, отримуючи сповіщення про успішну оплату.
Якщо вам потрібно продовжити воронку на основі успішної оплати, використовуйте блок "Стартовий тригер". У цьому випадку клієнт перейде з платіжного блоку до блоку "Стартова умова тригера", з якого ви зможете продовжити воронку.