WalletOne(Единая касса)
Если Вам необходимо принимать международные платежи, Единая касса вам в этом поможет.
Last updated
Если Вам необходимо принимать международные платежи, Единая касса вам в этом поможет.
Last updated
Для подключения walletone Вам потребуются id магазина и секретный ключ. id магазина можно найти в правом верхнем углу вашего аккаунта:
Для того чтобы бот получал уведомления об оплате, также необходимо установить в личном кабинете Единой кассы в разделе «Настройки», во вкладке «Интеграция» заполнить поле: Данные для отправки результата транзакции: https://chatter.salebot.pro/walletone_callback/result и сгенерировать «секретный ключ», как показано на рисунке:
После генерации секретного ключа обязательно нажмите кнопку «Сохранить» внизу страницы. Это необходимое условие для корректной работы.
Подробнее об условиях работы можно прочитать на сайте https://www.walletone.com/
Для подключения wallenone необходимо перейти в раздел "Платежные системы"
Далее необходимо просто указать данные, о которых говорили выше в форму.
На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.
Для генерации ссылки на оплату вам необходимо установить значение переменной payment_sum, сразу после этого появится переменная walletone_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: https://wl.walletone.com/checkout/checkout/Index?i=355956321993&m=126335067885
Walletone принимает платежи в нескольких валютах, по умолчанию платеж создается в рублях. Для указания другой валюты вам необходимо присвоить значение переменной currency. Переменная принимает значения: UAH RUB BYN USD TJS KZT EUR PLN ZAR
Например, как на скрине ниже, чтобы указать валюту гривны, можно установить эту переменную в настройках проекта.
Вы можете добавить описание платежа - оно будет отображаться в заголовке формы оплаты.
Описание берется из переменной payment_description
Описание должно быть только на латинице!
После успешной или неуспешной оплаты в бот придут колбэки, по которым вы сможете понять, что была успешная оплата. Эти колбэки в системе вы видите как сообщения от пользователя. Чтобы их не мог отправить пользователь, они состоят из ключа walletone и приписки со статусом, например: 793638786d31756066695c5a7b426739684e4e7449323344484353_success или 793638786d31756066695c5a7b426739684e4e7449323344484353_fail. Также после успешной оплаты переменная walletone_payment_completed устанавливается в True. Эти колбэки НЕ ВИДИТ пользователь, они отображаются только оператору
Тип сравнения должен быть "Полное совпадение"
Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки
После завершения оплаты клиенту добавится переменная walletone_callback_data, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.
Пример схемы, которая позволит протестировать быстро начать работу с Walletone.
На рисунке показан пример первого блока, в котором пользователя спрашивают сколько он хочет оплатить.
Ниже настройки стрелки, в ней должен быть включен переключатель "Пользователь вводит данные" и в поле вписана переменная payment_sum.
Обратите внимание, переменная #{walletone_pay_url} вставляется в разделе "Настройка вложений".
Далее можно сделать развилку на два блока (или создать зеленые блоки с условиями). В одной стрелке в условии прописываем qxgZ7zkNX4HHnG8UpZ61_success - колбек об успешной оплате, во второй: qxgZ7zkNX4HHnG8UpZ61_fail - колбек о не успешной оплате.
Тип проверки обязательно поставьте "Полное совпадение", иначе условия будут срабатывать на оба колбека.