# Paybox.money ## **Регистрация** Для получения необходимых данных для интеграции сервиса Paybox с Salebot необходимо зайти в “личный кабинет” - “разработчикам” и забрать со страницы следующие данные:\ **Paybox merchant\_id** - Идентификатор магазина - в примере 545273\ **Paybox secret\_key** - Секретный ключ для приема платежей - в примере t2JM\*\*\*\*\*\*\*\*\*\*\ **Paybox payout\_secret\_key** - Секретный ключ для выплат клиентам - в примере ![](https://lh4.googleusercontent.com/VNVDnLQ3QaZUr1GI0d04d3BZVDO7VCGWjPuURlagxIHqZeec7ZrGWSHxDSvt2KqnQ7Dss-Rg2fmzrpwKaJSGMghgMjxGAkzihLe0ghtzQKJ0gTKZk6wUYPKc6SoS2y0e9URbOQ6XQFHCIbouLRLV_sc) Так же для получения уведомлений об успешных платежах, следует пройти в “личный кабинет” - “настройки” - “магазины” и заполнить соответствующие поля. В подразделе “Системные настройки” следует вставить следующие данные:\ - check url\ - result url\ - success url\ **GET** - request method\ **Все платежи** - дефолтный фильтр В поле site url можно ввести URL сайта магазина для показа покупателю ссылки, по которой он может вернуться на сайт магазина после создания счета(необязательно). ![](https://lh4.googleusercontent.com/FeFS9xFxqdiPDIIkQMdN-N0e11aryjUs6-OohHNkpUhcWWPxhbP63J2azNiYppWUClfW1YpehvnMy3rWKttHn0by18fjD8fU8eY1MiNXzJ_Pqw7S1jisPDH391NUS7CsujD5p-ug88CEEk4ePpc4HVI) Для подключения платежной системы Paybox вам потребуется ввести полученные данные в настройках в Salebot. В salebot открываем раздел платежные системы, выбираем Paybox и вводим их. ![](https://lh3.googleusercontent.com/vrOizNC-17ApX9c-PMTnN08HL0ve3yEB5LA1u2WJkcoebVN-ToVk7tDH3fYHoARIwzHsVzzR0kpOj5r5g93Chi-KICFHJXLF9jt-qTJexsgAF9EK_eTCfNCXd8bVelZL9u5IO2i0BKEHRyYYnY6CmKk) ## **Генерация ссылки на оплату** Для генерации ссылки на оплату Вам необходимо установить значение переменной payment\_sum (например, 20), сразу после этого появится переменная paybox\_pay\_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: \ ; Также до установки значения переменной payment\_sum, можно задать следующие необязательные переменные для настройки платежа: * currency - валюта платежа. Если оставить переменную пустой, платеж будет произведен в рублях (‘RUB’). * paybox\_description – описание платежа. Если его не указать, будет добавлено стандартное описание “Оплата онлайн счета {номер счета}” * paybox\_bill\_lifetime - продолжительность жизни платежки в минутах. Если его не указать, ссылка на платежку будет действительна в течение 5 минут с ее создания * paybox\_test - Вы можете установить значение переменной равное 1, тогда следующий платеж пройдет в тестовом режиме. Не забудьте очистить переменную, когда потребуется совершать боевые платежи! {% hint style="info" %} Подробнее о том, какие карты можно указать для тестовых транзакций, Вы можете узнать в личном кабинете Paybox в разделе для разработчиков {% endhint %} ![](https://lh5.googleusercontent.com/c4dAVCgnqzPp4q_y9RBFdUQB7VEjzb7VF68lCmtgR6uaITv7j19Lcx71mI2qDXqGwYQBeBH7c9Bux2Mnc5qSUFxd7lqMxX2D1MA8tTHmukgObduVWMjuu2wXfg2qfdKAppBIBzVChK45XVP478YaFZk) ### **Пример формирования ссылки на оплату** Создадим ссылку на оплату в размере 20 рублей (внимание: в случае, если сумма окажется меньше минимальной, придет соответствующее сообщение. Минимальные суммы зависят от вида валют в Paybox). ![](https://lh3.googleusercontent.com/RvfJ0y69PohbuW3t5pPzynxjxmdKfCA9xioSJ92ag2piLnCjx_t5OxA1uhD1O0PAajgXG2k2aWFt0ovx6i3xFahXSQ7Vsev6zbUnLk8TITBBqcdS3LyILOU2qTrRTKh2BeSpv82vC2Epg_-j09wDKkc) {% hint style="warning" %} Обратите внимание: сначала задаются дополнительные переменные для настроек, затем payment\_sum. {% endhint %} Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример. Далее в нужном месте выводим переменную paybox\_pay\_url, в которой содержится ссылка для оплаты ![](https://lh4.googleusercontent.com/PPLYBtRG0x8UtakrVwkOxP0KtGvCfIZtUcaJoAakkVnC2FcGdnGTTqhpgdSLS6nYujxy-EhWp5nRcOQJkQ8_bApJeKu3kfprONYL1pPW2keimzBQDYa55IM0oJsltHyenEz8QYr-d1UxdYqej2ZS0Qk) ## **Обработка результата оплаты (callback об оплате)** После успешной оплаты в бот придут callback , по которым вы сможете понять, что была успешная оплата. Эти callback в системе Вы видите как сообщения от пользователя. Чтобы их не мог отправить пользователь, они состоят из идентификатора merchant и приписки success, например: 545273\_success ![](https://lh6.googleusercontent.com/CWgSbzBB5yyLdwJDJlKYy1wICwh7U3_JIX7jZYvDOMMoASRLBBjdMQBA8sDjtkvJOPLoBsnRboo0lt3jjoOp-7F1mW7jEqKp7BsnBIH1aho8fkLx5k8dQFNSmPYqnC3yznuz93hFEh7c0rx_MJQkCro) Эти callback НЕ ВИДИТ пользователь - они отображаются только оператору. **Тип сравнения должен быть "Полное совпадение"** \ Также после успешной оплаты переменная paybox\_payment\_completed устанавливается в True. Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю: ![](https://lh5.googleusercontent.com/dwlBzak3kZD2lwzXycLaANHXRAo0aVYp0-kO717oHyY2pm2bTJYl9ouZpFChA4xnXaNep-OvEnDkojzZ4o_1iAB89EAFm9SWSMQ0sp2Iz8ISxUQrXDWww89F8KCcFQosxNyYbpHqifMEln9VKMBk-Mc) После завершения оплаты клиенту добавится переменная paybox\_payment\_callback, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get. Также в систему Salebot может прийти **callback о неуспешной оплате** вида 545273\_fail, однако, следует иметь ввиду, что в связи с особенностями формирования платежных страниц в Paybox - а именно возможностью повторно оплатить счет по той же платежной ссылке в случае неудачи - система засчитывает неудачу по оплате только в том случае, если клиент прошел по уже просроченной ссылке. В случае, если он совершает попытки оплаты с действующей ссылки, callback о проваленной оплате не придет. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.salebot.pro/integration/payments/paybox.money.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.