Wayforpay
Швидка реєстрація та підтвердження продавця
Реєстрація продавця для фізичних осіб без вебсайту
Єдиний відсоток для фізичних та юридичних осіб – 2.5%
Підтримка Google Play та Apple Pay
Як підключити
Для підключення платіжної системи wayforpay вам знадобляться 3 значення:
логін продавця
секретний ключ продавця
доменне ім’я сайту продавця.
Перейдіть до свого особистого кабінету -> налаштування магазину https://m.wayforpay.com/mportal/merchant/list
Скопіюйте дані та перейдіть до налаштувань у Mavibot.
Відкрийте розділ "Еквайринг", виберіть wayforpay.
Потрібно ввести отримані дані у форму, що відкриється:
Щоб згенерувати посилання на оплату, потрібно задати значення payment_sum змінна (наприклад, 150 або 100.55, якщо сума дробова, то сума відокремлюється крапкою):
Одразу після цього, wayforpay_pay_url з’явиться змінна. Цю змінну можна вивести в повідомленні з посиланням або розмістити на кнопці з текстом "Сплатити":
Варіант 1. Посилання на оплату в кнопці:
Варіант 2. Посилання на оплату у полі attachment url:
Посилання має вигляд:
https://secure.wayforpay.com/invoice/id1bbb2ad0375
За замовчуванням USD (долари) встановлено, якщо вам потрібна інша валюта, потрібно задати значення змінної currency.
Також перед встановленням значення payment_sum змінної можна задати такі необов'язкові змінні для налаштування платежу.
currency - валюта замовлення за замовчуванням, UAH (можливі значення: USD, EUR, RUB)
session_timeout - час життя посилання в секундах, за замовчуванням 3600 (1 година)
product_name - назва товару
language - мова платіжної сторінки, за замовчуванням UA (можливі значення: RU, EN) buyer_name - ім’я клієнта
buyer_email - email клієнта
buyer_first_name - ім’я клієнта
buyer_last_name - прізвище клієнта
Ось так виглядає посилання на платіжну сторінку.
Створимо посилання для оплати на суму 1 USD і терміном дії 2 години:
Зверніть увагу: - Спочатку вкажіть необов’язкові параметри product_name ad тощо. - І останнє, присвойте значення payment_sum змінну.
Зверніть увагу, що спочатку ми задаємо змінні для налаштувань, потім payment_sum. Змінні можна задавати раніше в ланцюжку, а не в одному блоці, це приклад.
Далі, в наступному блоці, виводимо wayforpay_pay_url змінну, яка містить посилання (наприклад, посилання в тексті):
Ласкаво просимо, #{Name}!
Як обробити результат
Після успішної оплати до бота будуть надіслані колбеки, які повідомлять, що платіж успішний. Ви бачите ці колбеки в системі як повідомлення від користувача, щоб користувач не міг їх надіслати, вони складаються з перших 10 символів секретного ключа та приписки _success, наприклад: flk3409ref_success
Ці колбеки НЕ ВИДИМІ для користувача, вони відображаються лише оператору.
Тип порівняння має бути "Complete Match"
Також після успішної оплати змінна wayforpay_payment_completed встановлюється в True.
Наприклад, ви можете обробити успішний платіж у умовному блоці та відобразити відповідне повідомлення користувачеві:
Якщо ви не хочете викидати клієнта з основної схеми чатбота, використовуйте блок "Non state with a condition". У цей блок не можна перейти, тому клієнт не буде викинутий з основної воронки після оплати та отримає сповіщення про успішну оплату.
А якщо вам потрібно продовжити воронку з реакцією на успішну оплату, тоді використовуйте блок «Початкова умова», після чого клієнт перейде з блоку оплати до блоку «Початкова умова», з якого ви зможете продовжити воронку.
Докладніше про умовні блоки наведено в статті з однойменною назвою
Після завершення платежу 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) - генерує посилання для повторюваного платежу.
amount
сума платежу
currency
валюта. За замовчуванням: UAH (можливі значення: USD, EUR, RUB). Необов’язковий параметр.
session_timeout
час життя посилання в секундах. За замовчуванням: 3600 (1 година). Необов’язковий параметр.
product_name
назва товару. Необов’язковий параметр.
language
мова платіжної сторінки. За замовчуванням: UA (можливі значення: RU, EN). Необов’язковий параметр.
buyer_name
ім’я клієнта. Необов’язкове ім’я.
buyer_email
Email клієнта. Необов’язковий параметр.
regular_date_next
дата наступної автоматичної транзакції. За замовчуванням: через один місяць після створення посилання. Необов’язковий параметр.
regular_date_end
дата завершення автоматичних транзакцій. За замовчуванням: через один рік після створення посилання. Можна не вказувати, якщо задано параметр regular_count. Необов’язковий параметр.
regular_count
кількість автоматичних транзакцій. Якщо вказано, параметр regular_date_end буде проігноровано. Необов’язковий параметр.
regular_mode
інтервал повторюваного платежу. Необов’язковий параметр. Можливі значення: - once - одноразовий платіж - daily - щодня - weekly - щотижня - quarterly - кожні 3 місяці після дати першого платежу - monthly - раз на місяць - bimonthly - раз на 2 місяці - halfyearly - раз на 6 місяців - yearly -раз на рік
Скасування повторюваного платежу
wayforpay_delete_recurrent() - скасовує майбутні автоматичні платежі клієнта. Повертає "Ok" після успішного виконання.
Ви також можете використовувати блоки "Starting trigger" і "State" (у прикладі використано блоки "Non-state with condition" і "Non-state").
Якщо ви не хочете видаляти клієнта з основного потоку чатбота, використовуйте блок "Non-state with condition" — цей блок не можна ввести вручну, тому клієнт залишиться в основній воронці після оплати, але отримає сповіщення про успішну оплату.
Якщо вам потрібно продовжити воронку на основі успішної оплати, використовуйте блок "Starting trigger". У цьому випадку клієнт перейде з блоку оплати до блоку "Starting trigger condition", з якого можна продовжити воронку.
Останнє оновлення