Как подключить
Для подключения платежной системы Fondy вам понадобятся идентификатор мерчанта и секретный ключ. После их получения переходим в настройки в Mavibot
В Mavibot открываем раздел платежных систем, выбираем Fondy. Необходимо ввести полученные данные.
Чтобы сгенерировать ссылку на платеж, необходимо задать значение переменной payment_sum (например, 150 или 100.55 (через точку!)), сразу после этого появится переменная fondy_pay_url. Эту переменную можно отобразить в виде ссылки или разместить на кнопке с текстом «Оплатить».
Ссылка имеет вид:
Также перед установкой значения payment_sum можно указать следующие необязательные переменные для настройки платежа.
По умолчанию установлена гривна, если нужна другая валюта, необходимо задать значение переменной 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 символов секретного ключа и слова 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