Fondy
Підключіть до свого бота зручні онлайн-платежі з усього світу
Як підключити
Щоб підключити платіжну систему Fondy, вам знадобляться merchant ID і секретний ключ. Після їх отримання переходимо до налаштувань у Salebot
У Salebot ми відкриваємо розділ платіжних систем, обираємо Fondy. Потрібно ввести отримані дані.
Щоб згенерувати посилання на оплату, потрібно задати значення змінної payment_sum (наприклад, 150 або 100.55 (через крапку!)), одразу після цього з’являється змінна fondy_pay_url. Цю змінну можна вивести як посилання або розмістити на кнопці з текстом "Pay".
Посилання має такий вигляд:
https://payfondy.eu/merchants/4879cf99f26d58b22b04c037d111d14a/default/index.html?n=fe044b299ce98accfcd5f0c559d8c8f28802c3
Також перед встановленням значення 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 variable
Зверніть увагу: спочатку ми задаємо додаткові змінні для налаштувань, потім payment_sum. Ви можете визначати змінні раніше в ланцюжку, а не в одному блоці, це приклад.
Далі, у потрібному місці, виведіть fondy_pay_url змінну, яка містить посилання.
Як обробити результат
Після успішної оплати в бот прийде колбек, за яким можна зрозуміти, що оплата пройшла успішно. Ці колбеки в системі ви бачите як повідомлення від користувача, тому щоб їх не міг надіслати користувач, вони складаються з перших 5 символів секретного ключа та слова success, наприклад: h4fd56_success
Якщо пароль менше ніж 5 символів, тоді він використовується повністю, наприклад для тестових платежів пароль test, тоді callback прийде test_success
Ці колбеки НЕ ВИДНО користувачу, вони відображаються лише оператору
Тип порівняння має бути "Full match"
Також після успішної оплати для змінної 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
Last updated