Як підключити
Для підключення платіжної системи Fondy вам знадобляться merchant ID та секретний ключ. Після їх отримання переходимо до налаштувань у Mavibot
У Mavibot відкриваємо розділ платіжних систем, обираємо fondy. Потрібно ввести отримані дані.
Щоб згенерувати посилання на платіж, потрібно встановити значення змінної payment_sum (наприклад, 150 або 100.55 (через крапку!)), одразу після цього з'являється змінна fondy_pay_url. Цю змінну можна відобразити з посиланням або розмістити на кнопці з текстом «Оплатити».
Посилання має вигляд:
Також перед встановленням значення payment_sum можна вказати наступні додаткові змінні для налаштування платежу.
Типове налаштування — UAH, якщо потрібна інша валюта, необхідно встановити значення змінної currency
currency — Валюта замовлення.
Допустимі значення:
UAH — українська гривня
RUB — російський рубль
USD — долар США
EUR — євро
GBP — фунт стерлінгів обов'язково
CZK — чеська крона
payment_description — опис замовлення
session_timeout — час життя замовлення в секундах.
типове значення (36000 секунд = 10 годин).
language — Мова сторінки оплати:
ru — російська
uk — українська
en — англійська
lv — латиська
fr — французька
cs — чеська
ro — румунська
it — італійська
sk — словацька
pl — польська
es — іспанська
hu — угорська
de — німецька
Як створити посилання
Створіть посилання на оплату 122 грн (типово гривня)
Зверніть увагу:
- Спочатку вкажіть додаткові параметри payment_description тощо.
- І останнім призначте значення змінної payment_sum
Зверніть увагу, спочатку ми встановлюємо додаткові змінні для налаштувань, потім payment_sum. Ви можете визначити змінні раніше в ланцюжку, а не в одному блоці, це лише приклад.
Далі у потрібному місці виведіть змінну fondy_pay_url, яка містить посилання.
Як обробити результат
Після успішної оплати в бот прийдуть колбеки, за якими можна зрозуміти, що відбулася успішна оплата. Ці колбеки в системі ви бачите як повідомлення від користувача, тому вони не можуть бути надіслані користувачем, вони складаються з перших 5 символів секретного ключа та account success, наприклад: h4fd56_success
Якщо пароль коротший за 5 символів, то пароль буде використано повністю, наприклад, для тестових платежів пароль test, тоді колбек прийде test_success
Ці колбеки НЕ ВИДНО користувачеві, вони відображаються лише оператору
Тип порівняння має бути «Повний збіг»
Також після успішної оплати змінна fondy_payment_completed встановлюється в True.
Наприклад, ви можете зробити блок успішної обробки платежу з умовою та вивести відповідне повідомлення користувачеві:
Після завершення платежу до клієнта буде додано змінну fondy_callback_data, яка містить дані відповіді платіжної системи для завершеної транзакції. Ви можете витягти необхідні дані зі словника за допомогою методу get.
Щоб здійснити повторний платіж, необхідно скинути payment_sum, раніше згенероване посилання, і після скидання змінної payment_sum отримати нове посилання. Ви можете вказати попереднє значення.
Як зробити тестові платежі
Тестові дані на момент публікації документації:
Merchant ID: 1396424
Пароль: test
Тестові номери карток
44445566661111 — Успішно
4444111166665555 — Відмова
Термін дії та CVV2 будь-які
Якщо щось не працює, порівняйте дані з даними на офіційному сайті: https://docs.fondy.eu/ru/docs/page/2/2