Paybox.money

Оплата на вашем сайте по картам со всего мира

Регистрация

Для получения необходимых данных для интеграции сервиса Paybox с Salebot необходимо зайти в “личный кабинет” - “разработчикам” и забрать со страницы следующие данные: Paybox merchant_id - Идентификатор магазина - в примере 545273 Paybox secret_key - Секретный ключ для приема платежей - в примере t2JM********** Paybox payout_secret_key - Секретный ключ для выплат клиентам - в примере

Так же для получения уведомлений об успешных платежах, следует пройти в “личный кабинет” - “настройки” - “магазины” и заполнить соответствующие поля. В подразделе “Системные настройки” следует вставить следующие данные: https://chatter.salebot.pro/paybox_callback/result - check url https://chatter.salebot.pro/paybox_callback/result - result url https://chatter.salebot.pro/paybox_callback/success - success url GET - request method Все платежи - дефолтный фильтр

В поле site url можно ввести URL сайта магазина для показа покупателю ссылки, по которой он может вернуться на сайт магазина после создания счета(необязательно).

Для подключения платежной системы Paybox вам потребуется ввести полученные данные в настройках в Salebot. В salebot открываем раздел платежные системы, выбираем Paybox и вводим их.

Генерация ссылки на оплату

Для генерации ссылки на оплату Вам необходимо установить значение переменной payment_sum (например, 20), сразу после этого появится переменная paybox_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".

Ссылка имеет вид: https://customer.paybox.money/pay.html?customer=8235a19a9333cd08deb960f64e0250d3

Также до установки значения переменной payment_sum, можно задать следующие необязательные переменные для настройки платежа:

• currency - валюта платежа. Если оставить переменную пустой, платеж будет произведен в рублях (‘RUB’).

• paybox_description – описание платежа. Если его не указать, будет добавлено стандартное описание “Оплата онлайн счета {номер счета}”

• paybox_bill_lifetime - продолжительность жизни платежки в минутах. Если его не указать, ссылка на платежку будет действительна в течение 5 минут с ее создания

• paybox_test - Вы можете установить значение переменной равное 1, тогда следующий платеж пройдет в тестовом режиме. Не забудьте очистить переменную, когда потребуется совершать боевые платежи!

Подробнее о том, какие карты можно указать для тестовых транзакций, Вы можете узнать в личном кабинете Paybox в разделе для разработчиков

Пример формирования ссылки на оплату

Создадим ссылку на оплату в размере 20 рублей (внимание: в случае, если сумма окажется меньше минимальной, придет соответствующее сообщение. Минимальные суммы зависят от вида валют в Paybox).

Обратите внимание: сначала задаются дополнительные переменные для настроек, затем payment_sum.

Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример. Далее в нужном месте выводим переменную paybox_pay_url, в которой содержится ссылка для оплаты

Обработка результата оплаты (callback об оплате)

После успешной оплаты в бот придут callback , по которым вы сможете понять, что была успешная оплата.

Эти callback в системе Вы видите как сообщения от пользователя. Чтобы их не мог отправить пользователь, они состоят из идентификатора merchant и приписки success, например: 545273_success

Эти callback НЕ ВИДИТ пользователь - они отображаются только оператору. Тип сравнения должен быть "Полное совпадение" Также после успешной оплаты переменная paybox_payment_completed устанавливается в True. Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

После завершения оплаты клиенту добавится переменная paybox_payment_callback, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.

Также в систему Salebot может прийти callback о неуспешной оплате вида 545273_fail, однако, следует иметь ввиду, что в связи с особенностями формирования платежных страниц в Paybox - а именно возможностью повторно оплатить счет по той же платежной ссылке в случае неудачи - система засчитывает неудачу по оплате только в том случае, если клиент прошел по уже просроченной ссылке. В случае, если он совершает попытки оплаты с действующей ссылки, callback о проваленной оплате не придет.