# Robokassa {% hint style="success" %} Всем, **зарегистрировавшимся** [**по ссылке**](https://partner.robokassa.ru/Reg/Register?PromoCode=01spirin\&culture=ru) **(или промокоду),** предоставляются лояльные стартовые условия в виде тарифного плана «Реальный» (**2.9%**) сроком на 3 календарных месяца. Промокод: **01spirin** {% endhint %} {% hint style="danger" %} **Robokassa не работает с физическими лицами**. {% endhint %} * [Как настроить Robokassa](#kak-nastroit-robokassa) * [Как настроить Salebot ](#kak-nastroit-salebot) * [Кнопка с функцией Оплата](#knopka-s-funkciei-oplata) * [Функция `get_robokassa_payment_url` в Калькуляторе](#funkciya-get_robokassa_payment_url-v-kalkulyatore) * [Создание ссылки с помощью переменной payment\_sum](#sozdanie-ssylki-s-pomoshyu-peremennoi-payment_sum-i-dopolnitelnykh-parametrov) * [Как сформировать чеки ](#cheki) * [Какие могут быть ошибки ](#vozmozhnye-oshibki) * [Как проводить автоматические платежи сервиса Robokassa ](#kak-provodit-avtomaticheskie-platezhi-servisa-robokassa) * [Какие требования сервиса Robokassa к чат-ботам](#kakie-trebovaniya-servisa-robokassa-k-chat-botam) ## Как настроить Robokassa Рассмотрим как реализовать прием оплат в боте через сервис Robokassa. 1. Создайте интернет-магазин в личном кабинете сервиса Robokassa и укажите данные технические настройки: \- Алгоритм расчета хеша: MD5\ \- Result Url: \- Метод отсылки данных по Result Url: GET\ \- Success Url: \- Метод отсылки данных по Success Url: GET\ \- Fail Url: \- Метод отсылки данных по Fail Url: GET (Рисунок 1)

рис. 1

{% hint style="warning" %} Создайте тестовые пароли и первоначальную настройку проводите в тестовом режиме. {% endhint %} ## Как настроить Salebot Зайдите в раздел "Эквайринг":

Найдите кнопку Robokassa для подключения сервиса:

и заполните форму в открывшейся форме:

1. **Поле Идентификатор магазина —** Shop ID, который вы можете найти в настройках магазина в личном кабинете робокассы. 2. Пароли #1, пароль #2 — уникальные сгенерированные последовательности цифр+букв (см. рис. 1). 3. **поле Ставка НДС.** Необходимо указать подходящий код для передачи значения НДС. Например, `none` - если без НДС или `vat0` - если ставка НДС 0% . Доступные варианты ставки НДС: * none — без НДС * vat0 — 0% * vat10 — 10% * vat20 — 20% * vat110 — 10/110 * vat120 — 20/120 * vat5 – 8 – НДС по ставке 5% * vat7 – 9 – НДС по ставке 7% * vat105 – 10 – НДС чека по расчетной ставке 5/105 * vat107 – 11 – НДС чека по расчетной ставке 7/107 4. **поле Система налогообложения.** Можно выбрать систему налогообложения, которая будет передана в чеке. Необязательное поле, если у организации имеется только один тип налогообложения. (Данный параметр обязательно задается в личном кабинете магазина)

Рис. 5. Выбор системы налогообложения для формирования чека об оплате

На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал. 5. **поле Доменная зона.** Доступные значения ru и kz. Ссылка будет иметь вид robokassa.ru или robokassa.kz

## Как сформировать ссылку на оплату {% hint style="success" %} Сформировать ссылку на оплату в блоке можно **ОДНИМ ИЗ** из доступных способов: * [Кнопка с функцией Оплата ](#knopka-s-funkciei-oplata)или * [Функция get\_robokassa\_payment\_url в Калькуляторе](#funkciya-get_robokassa_payment_url-v-kalkulyatore) или * [Создание ссылки с помощью переменной payment\_sum и дополнительных параметров](#sozdanie-ssylki-s-pomoshyu-peremennoi-payment_sum-i-dopolnitelnykh-parametrov) (устаревшая работающая версия) {% endhint %} ## Кнопка с функцией Оплата Ссылку на оплату можно создавать в кнопке с функцией "Оплата". О том как создавать такую кнопку рассказано в этой статье: {% embed url="" %} Статья про кнопку с функцией Оплата {% endembed %} Рассмотрим все возможные параметры данной кнопки. О том как создавать кнопку с функцией Оплата рассказано в этой статье: ### **Обязательные параметры кнопки Оплата для сервиса Robokassa** Для формирования ссылки на оплату в настройках кнопки необходимо указать **обязательные параметры: Сумма и Наименование товара.**

Рис. 7. Форма настройки кнопки оплаты в блоке чат-бота

**поле Сумма.** В этом поле указываем стоимость товара в рублях **поле Наименование товара.** В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания. Максимальная длина — 100 символов. Эта информация отображается в интерфейсе Robokassa и в Электронной квитанции, которую получает клиент после успешного платежа. {% hint style="danger" %} **НЕЛЬЗЯ** использовать **двойные кавычки** в наименовании товара: удалите или замените на одинарные кавычки. {% endhint %} **чекбокс Автоплатеж.** Для подключения автоплатежа **чекбокс С уведомление о клике.** Для отслеживания перехода по ссылке для оплаты можно поставить галочку. В таком случае, при клике по кнопке в диалог с клиентом в Сейлбот придет уведомление о том, что был совершен переход по ссылке На данное уведомление можно настраивать дальнейшую логику работы бота. {% hint style="info" %} Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.\ Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией. {% endhint %} ### **Для формирования чека** **меню Данные для формирования чека.** При клике откроется выпадающее меню с параметрами для формирования чека:

Рис. 8. меню "Данные для формирования чека"

**поле Название товара**. **Обязательное для формирования чека.** {% hint style="danger" %} **НЕЛЬЗЯ** использовать **двойные кавычки** в Названии товара: удалите или замените на одинарные кавычки. {% endhint %} **поле Полная сумма в рублях.** В данном поле необходимо указать сумму к оплате с учетом количества товаров. Если количество равно 1, то Полная сумма в рублях равна значению в поле Сумма в обязательном поле настройки кнопки **поле Количество.** Количество или вес товара. Передать можно целое или дробное число через точку. Пример, 5 или 10.3 ### Переменные клиента, которые будут созданы автоматически при использовании кнопки с функцией Оплата Как только пользователь получит блок с кнопкой "Оплата" автоматически будут созданы переменные клиента:

Служебная переменная клиента **`__payments`** , которая хранит сумму, идентификатор созданной ссылки, нужна для идентификации хука от платежной системы. {% hint style="danger" %} Служебную переменную клиента \_\_payments НЕЛЬЗЯ удалять или изменять! {% endhint %} Переменная клиента **`error_payment_button`** создается, если при формировании кнопки возникла ошибка. В значение переменной error\_payment\_button запишется либо текст ошибки, либо ответ платежной системы с ошибкой. {% hint style="warning" %} Значение переменных становятся актуальными при переходе в следующий блок {% endhint %} ### Как обработать результат {% hint style="warning" %} Обращаем внимание! Robokassa отсылает уведомление только по успешным транзакциям по параметру Result URL. **Коллбэков о неуспешных платежах в сервисе Robokassa нет.** Fail URL - это только страница неуспешной оплаты, куда будет переадресован плательщик в случае возникновения кодовой ошибки на платежной странице. {% endhint %} **Успешный платеж.** После того, как вы верно настроите оплату и сформируете ссылку для проведения платежа, протестируйте созданные настройки. Если оплата пройдет успешно, то в диалог клиента (раздел "Клиенты") **АВТОМАТИЧЕСКИ** придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_success и через пробел сумма платежа. **Коллбэк генерируется автоматически**, его не надо составлять самим или запрашивать в поддержке платежной системы,

Рис. 10. Блок "Стартовое условие" с кнопкой оплаты

Например: `ovg58keefc_success 2999`, где: ovg58keefc : 10 символов секретного ключа платежной системы \_success : результат обработки запроса (успешный платеж) 2999 : сумма платежа Отработка блока:

Колбек:

{% hint style="info" %} Коллбэки (уведомления) от платежной системы пользователь НЕ ВИДИТ. Они отображаются только во вкладке "Клиенты" и видны оператору/администратору. {% endhint %} ### Пример настройки реакции на коллбэк В блоке с условием (это может быть как блок "Стартовое условие", так и блок "Не состояние с условием") необходимо указать коллбэк, который приходит при оплате. {% hint style="warning" %} Важно: выбор соответствия Полное совпадение или По наличию ключевых слов {% endhint %}

Рис. 14. Реакция на колбек с помощью блока "Стартовое условие"

Далее при оплате клиенту будет приходить сообщение из блока, в котором настроена реакция на коллбэк:

**Платеж с ошибкой** Если сумма указанная в настройках кнопки **отличается от суммы, которую клиент оплатил**, в бота **АВТОМАТИЧЕСКИ** придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_different\_amounts и через пробел уникальный ID платежа Например: `ovg58keefc_different_amounts 123456` , где: `ovg58keefc` : 10 символов секретного ключа платежной системы `_different_amounts` : результат обработки запроса (сумма оплаты отличается от суммы в ссылке) `123456` : уникальный ID платежа ## Функция get\_robokassa\_payment\_url в Калькуляторе Для формирования ссылки на оплату можно воспользоваться функцией `get_robokassa_payment_url` в Калькуляторе блоке. В поле Калькулятор переменной присвоим значение функции `get_robokassa_payment_url` {% hint style="info" %} Название переменной задаете самостоятельно. На скринах примеры названия переменных. {% endhint %} В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом "Оплатить". **ПРИМЕР ссылки на оплату:**: `https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda` {% hint style="info" %} Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.\ Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией. {% endhint %} {% tabs %} {% tab title="Калькулятор" %} Пример 1:

Рис. 16. Пример формирования ссылки: переданы только обязательные параметры

{% endtab %} {% tab title="Описание параметров" %} `get_robokassa_payment_url(amount, description, products_for_receipt, taxation, recurrent, country, currency)` #### Параметры функции:

Параметр	Значение параметра
`amount`	Сумма к оплате. В этом поле указываем стоимость товара в рублях. (Обязательный параметр)
`description`	Наименование товара. В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания. Максимальная длина — 100 символов. Эта информация отображается в интерфейсе Robokassa и в Электронной квитанции, которую получает клиент после успешного платежа. (Обязательный параметр)
`products_for_` `receipt`	Параметры для формирования чеков. Подробнее читайте здесь.
`taxation`	Система налогообложения. Подробнее читайте здесь.
`recurrent`	Подключение автоплатежа. Если автоплатеж включен, то передать значение 1, если отключен передайте значение None
`country`	Доменная зона. Если пропустить значение или передать значение None, то по умолчанию доменная зона будет .ru Ссылка будет иметь вид robokassa.ru. Для Казахстана можно передать значение 'kz' . В этом случае ссылка будет иметь вид robokassa.kz
`currency`	Трехбуквенный код валюты. Необходимо передавать значение строго по параметрам, принимаемым сервисом Robokassa. USD - доллар; RUB - рубль; EUR - евро; KZT - тенге.

{% endtab %} {% tab title="Пример кода для копирования" %} Пример 1: Ссылка на оплату без чека\ \ `res = get_robokassa_payment_url(100, 'Купи меня')` Пример 2: Ссылка на оплату с чеком\ \ `receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]` `res = get_robokassa_payment_url(100, 'Купи меня', receipt, '3', 1, 1)` {% endtab %} {% endtabs %} {% hint style="info" %} Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Купить". {% endhint %} {% hint style="warning" %} Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной **`error_payment_func`** \ Ошибка запишется по последней функции в Калькуляторе {% endhint %} После того, как вы верно настроите оплату и сформируете ссылку для проведения платежа, протестируйте созданные настройки. ## Как добавить описание платежа Вы можете добавить описание к платежу, установив переменную **payment\_description**

Это описание будет отображаться в форме оплаты, а также на чеке. ### Как обработать результат Если оплата пройдет успешно, то в диалог клиента (раздел "Клиенты") **АВТОМАТИЧЕСКИ** придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_success и через пробел сумма платежа. **Коллбэк генерируется автоматически**, его не надо составлять самим или запрашивать в поддержке платежной системы, Например: `ovg58keefc_success 1500`, где: ovg58keefc : 10 символов секретного ключа платежной системы \_success : результат обработки запроса (успешный платеж) 1500 : сумма платежа {% hint style="success" %} Обращаем внимание! Колбек виден только вам в диалоге с клиентом. Клиенту колбек не виден, но вы можете настроить реакцию на успешную обработку платежа. {% endhint %} ### Пример Настройки блока с функцией `get_robokassa_payment_url:` 1. Если выдаете ссылку в тексте:

Рис. 17. настройка блока "Стартовое условие" с ссылкой на оплату

Отработка блока:

Рис. 18. Пример ссылки на оплату, отправляемой ботом.

{% hint style="warning" %} Важно! Ссылка на оплату является уникальной: ее нельзя скопировать и потом направлять другим клиентам! Направляйте ссылку на оплату через переменную в боте (см. рис. 17). {% endhint %} Коллбэк при успешной оплате:

2. Ссылка в кнопке:

Отработка блока:

Рис. 21. Пример отправки кнопки с ссылкой на оплату

Коллбэк при успешной оплате:

Рис. 22. Колбек об успешной оплате в диалоге с клиентом

## Создание ссылки с помощью переменной payment\_sum и дополнительных параметров Принимать оплату вы также можете генерируя ссылку с помощью переменной payment\_sum, в которой достаточно указать сумму платежа. {% hint style="info" %} **Обратите внимание:** переменной **payment\_sum** присваивается значение последней, после необязательных переменных **payment\_description, product\_name** и т.д. {% endhint %} Для генерации ссылки на оплату, вам необходимо установить значение переменной **payment\_sum**, сразу после этого появится переменная **robokassa\_pay\_url.** Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".

Рис. 23. Пример настройки блока "Стартовое условие"

**ПРИМЕР отработки блоки (ссылки на оплату):**

{% hint style="warning" %} Важно! Ссылка на оплату является уникальной: ее нельзя скопировать и потом направлять другим клиентам! Направляйте ссылку на оплату через переменную в боте (см. рис. 23). {% endhint %} Чтобы передавать ссылку в кнопке, укажите переменную в кнопке в поле url:

### Результат оплаты при формировании ссылки на оплату через payment\_sum После успешной оплаты в бот придет коллбэк. Этот коллбэк в системе вы видите как сообщение от пользователя, чтобы их не мог отправить пользователь, они состоят из первого пароля от сервиса Robokassa и приписки со статусом success, например: **qxgZ7zkNX4HHnG8UpZ61\_success.**

Рис. 25. Пример колбека об успешной оплате

Также после успешной оплаты переменная **robokassa\_payment\_completed** устанавливается в **True.** Этот коллбэк **НЕ ВИДИТ** пользователь, они отображаются только оператору {% hint style="danger" %} Тип сравнения должен быть "**Полное совпадение**" {% endhint %} {% hint style="warning" %} Для совершения повторного платежа обязательно необходимо обнулить **payment\_sum**, ранее сформированную ссылку и уже после переназначить переменную payment\_sum для получения свежей ссылки\ \ Пример обнуления переменных: \ robokassa\_pay\_url=''\ payment\_sum=0 {% endhint %} После завершения оплаты клиенту добавится переменная **robokassa\_callback\_data**, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода **get**. ## Как создать тестовую схему Пример схемы, которая позволит протестировать и быстро начать работу с сервисом Robokassa:

Рис. 26. Настройка блока "Стартовое условие"

На рисунке показан пример первого блока, в котором пользователя спрашивают, сколько он хочет оплатить**.** На рисунке ниже настройки стрелки, в ней должен быть включен переключатель "Пользователь вводит данные" и в поле вписана переменная **payment\_sum:**

Далее в следующем блоке оплаты добавьте кнопку и установите в строку url переменную **robokassa\_pay\_url:**

Рис. 28. Настройки блока с кнопкой оплаты

Схема отработает следующим образом:

При клике на кнопку сумма, которую прописал клиент, будет доступна к оплате в платежной форме:

После оплаты придет коллбэк, на который также можно настроить реакцию.

Рис. 32. Отправка колбека об успешной оплате

{% hint style="info" %} Важно! Колбека о неуспешной оплате в Robokassa не существует. {% endhint %} Для этого добавьте еще один блок с условием, а в строке с условием пропишите коллбэк вида "**qxgZ7zkNX4HHnG8UpZ61\_success":**

Рис. 33. Пример настройки блока "Не состояние с условием" для реакции на успешную оплату

{% hint style="info" %} Тип проверки обязательно поставьте "Полное совпадение" {% endhint %} Схема будет отрабатывать следующим образом:

### Видеоурок {% embed url="" %} ## Как сформировать запрос на фискализацию ### В кнопке с функцией “Оплата” При создании кнопки в выпадающем меню “Данные для формирования чека”, заполните поля “Название товара”, “Полная сумма в рублях”, “Количество”, “Ставка НДС”, “Система налогообложения”.

Подробнее в разделе "[Для формирования чека](#dlya-formirovaniya-cheka)". ### С помощью переменной payment\_sum Так как генерация ссылки производится в момент, когда вы установили значение переменной payment\_sum, вам необходимо задать переменные products\_for\_receipt и robokassa\_sno. {% hint style="warning" %} Важно: * при формировании ссылки через переменную payment\_sum, система налогообложения задаётся в переменной robokassa\_sno. * payment\_sum должна быть равна общей стоимости всех товаров (сумма всех параметров sum). {% endhint %} Пример: session\_timeout = 7200 product\_name = Первый платеж robokassa\_sno = osn products\_for\_receipt = \[{"name": "Наименование товара", "quantity": 2, "sum": 2, "tax": "none"}, {"name": "Наименование товара 2", "quantity": 1, "sum": 6, "tax": "none"}] payment\_sum = 10 ### Для функций get\_robokassa\_payment\_url и robokassa\_recurrent\_payment При вызове функций **get\_robokassa\_payment\_url** или функции **robokassa\_recurrent\_payment** передайте в качестве аргументов переменные **taxation** и **products\_for\_receipt** согласно описанию ниже**.** Функции подготовят ссылку с учётом товарной номенклатуры и сформируют запрос на фискализацию. {% hint style="warning" %} Важно: Переменные **taxation** и **products\_for\_receipt** должны задаваться для каждого отдельного платежа. Сервис Robokassa не хранит данные параметры и не сможет провести фискализацию платежей, для которых не была передана номенклатура. {% endhint %} 1. **products\_for\_receipt** - массив, содержащий товарную номенклатуру. Каждая единица товара должна быть представлена в виде словаря, содержащего параметры **name, quantity, sum, tax, payment\_method, payment\_object и nomenclature\_code**. \ **!**** products\_for\_receipt** нужно указать в следующем формате: \[ {"name": "Наименование товара", "quantity": "Количество товара", "sum": "Стоимость товара", "tax": "Ставка НДС"}, {"name": "Наименование товара 2", "quantity": "Количество товара 2", "sum": "Стоимость товара", "tax": "Ставка НДС"} ] где, 1\) **name** - наименование товара. Если в наименовании товара вы используете специальные символы, например кавычки, то их обязательно необходимо экранировать. 2\) **quantity** - количество или вес товара (целое или дробное число через точку) 3\) **sum** или **amount** (*обязательный, два варианта имени*) - полная сумма в рублях за все количество данного товара с учетом всех возможных скидок, бонусов и специальных цен. 4\) **tax** или **vat\_code** - (обязательный, два варианта имени, значение зависит от имени) - ставка НДС. Этот параметр устанавливает налоговую ставку в ККТ. {% tabs %} {% tab title="Значения для tax: " %}

Значение	Описание
none	без НДС
vat0	0%
vat10	10%
vat20	20%
vat110	10/110
vat120	20/120
vat5	5%
vat7	7%
vat105	5/105
vat107	7/107

{% endtab %} {% tab title="Значение для vat\_code:" %}

Значения	Описание
'1'	Без НДС
'2'	НДС по ставке 0%
'3'	НДС по ставке 10%
'4'	НДС чека по ставке 20%
'5'	НДС чека по расчетной ставке 10/110
'6'	НДС чека по расчетной ставке 20/120
'8'	НДС по ставке 5%
'9'	НДС по ставке 7%
'10'	НДС чека по расчетной ставке 5/105
'11'	НДС чека по расчетной ставке 7/107

{% endtab %} {% endtabs %} 5\) **method** или **payment\_method** - (два варианта имени, необязательный параметр) признак способа расчёта.

Возможные значения параметра:	Что подразумевает значение:
full_prepayment	предоплата 100%. Полная предварительная оплата до момента передачи предмета расчёта
prepayment	предоплата. Частичная предварительная оплата до момента передачи предмета расчёта
advance	аванс
full_payment	полный расчёт. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчёта;
partial_payment	частичный расчёт и кредит. Частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит;
credit	передача в кредит. Передача предмета расчёта без его оплаты в момент его передачи с последующей оплатой в кредит;
credit_payment	оплата кредита. Оплата предмета расчёта после его передачи с оплатой в кредит (оплата кредита).

6\) **object** или **payment\_object** - (два варианта имени, необязательный параметр) предмет расчета (если не передать, будет commodity (товар))

Возможные значения параметра	Что подразумевает значение
commodity	Товар. О реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар)
excise	Подакцизный товар. О реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар)
job	Работа. О выполняемой работе (наименование и иные сведения, описывающие работу)
service	Услуга. Об оказываемой услуге (наименование и иные сведения, описывающие услугу)
gambling_bet	Ставка азартной игры. О приеме ставок при осуществлении деятельности по проведению азартных игр
gambling_prize	выигрыш азартной игры. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
lottery	лотерейный билет. О приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
lottery_prize	выигрыш лотереи. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей
intellectual_activity	предоставление результатов интеллектуальной деятельности. О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
payment	платеж. Об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
agent_commission	агентское вознаграждение. О вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом;
composite	составной предмет расчета. О предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение выше перечисленных признаков
another	иной предмет расчета. О предмете расчета, не относящемуся к выше перечисленным предметам расчета
property_right	имущественное право
non-operating_gain	внереализационный доход
insurance_premium	страховые взносы
sales_tax	торговый сбор
resort_fee	курортный сбор

7\) **nomenclature\_code** - (условно обязательный) маркировка товара: передаётся в том виде, как она напечатана на упаковке товара. {% hint style="warning" %} Параметр является обязательным только для тех магазинов, которые продают товары, подлежащие обязательной маркировке. Код маркировки расположен на упаковке товара, рядом со штрих-кодом или в виде QR-кода. {% endhint %} 2. **taxation** — система налогообложения, которую использует магазин. Необязательное поле, если у организации имеется только один тип налогообложения. Может принимать строковые и численные значения: | Строковые значения | Численные значения | | ---------------------------------------------------------------- | --------------------------------------------- | | **osn** – общая СН | '1' - Общая система налогообложения | | **usn\_income** – упрощенная СН (доходы); | '2' - Упрощенная (УСН, доходы) | | **usn\_income\_outcome** – упрощенная СН (доходы минус расходы); | '3' - Упрощенная (УСН, доходы минус расходы) | | **esn** – единый сельскохозяйственный налог; | '5' - Единый сельскохозяйственный налог (ЕСН) | | **patent** – патентная СН. | '6' - Патентная система налогообложения | {% hint style="warning" %} Важно! Для фискализации важно передать параметры чека. Верный формат чека передается таким образом: rec = \[{"name": "Пакет 1 месяц", "quantity": 1, "sum": 4800, "tax": "none"}] response = robokassa\_recurrent\_payment(4800, 'Обучение в Лётной школе Авиатор', 'ru', rec, 'osn') где необходимо подставить свои данные. {% endhint %} ## Формирование чека при приеме оплаты в Курсах на странице курса Нужно выбрать в разделе "Оплата" в настройках курса платежную систему Robokassa:

Рис. 36. Выбор платежной системы в разделе "Оплата" в настройках курса

Заполните в разделе "Эквайринг" в настройках платежной системы (если не сделали это ранее) поля "Ставка НДС" и "Система налогообложения":

## Какие могут быть ошибки #### Код ошибки 40 «Повторная оплата счета с тем же номером невозможна». После успешного платежа необходимо перевести диалог в блок "Конец сбора данных", чтобы сформировался новый номер платежа. #### Код ошибки 34 «Услуга рекуррентных платежей не разрешена магазину». #### Код ошибки 31 «Неверная сумма платежа». Такая ошибка может возникнуть при переадресации клиента на платежную страницу для выставления счета. Она означает, что вы не передаете нам сумму, на которую необходимо провести платеж, либо передаете сумму, равную нулю. #### Код ошибки 29 «Неверный параметрSignature» Здесь причин может быть несколько, но все они связаны со скриптом, отвечающим за инициализацию оплаты (а конкретнее, его часть, которая формирует параметрSignatureпо формуле, состоящей из переменных). Эта ошибка встречается довольно часто, и вот 3 возможных причины: * **Первая:** некорректный Идентификатор магазина (MerchantLogin); * **Вторая:** неверный Пароль 1 (MerchantPass1); * **Третья:** вы используете дополнительные параметры (shp**\_**), которые добавлены в программный код кассы, но не занесены в формулу подсчета - или наоборот, в формуле подсчета они указаны, а в коде нет. Если таковые используются, передавайте их в алфавитном порядке – как в параметрах на оплату, так и в формуле подсчета Signature. Важный момент! Если вы работаете в тестовом режиме, передавая параметр IsTest=1 или включая его галочкой в настройках модуля/бота, используйте только тестовую пару технических паролей (закладка «Технические настройки» карточки вашего магазина). #### Код ошибки 23 «Тестовый платёж не может быть создан. У магазина отсутствуют настройки тестовых параметров». Это значит, что перед проведением тестового платежа вы не заполнили все необходимые данные в блоке «Параметры проведения тестовых платежей» закладки «Технические настройки». #### Код ошибки 25 «Магазин не активирован». Эта ошибка встречается нередко, и здесь могут быть 2 причины. * **Первая:** это действительно так – и необходимо активировать магазин, а лишь потом выставлять счет. * **Вторая:** вы неверно указали Идентификатор магазина в технических настройках на сайте. Посмотреть правильный можно в разделе «Мои магазины» Личного кабинета. Перейдите в закладку «Технические настройки» и найдите поле «Идентификатор магазина». Скопируйте идентификатор и введите его в настройках сайта. ## **Как проводить автоматические платежи сервиса Robokassa** Пошаговая инструкция подключения автоплатежей для сервиса **Robokassa** **Шаг 1. Включить автоплатежи в кнопке оплаты** Перейдите в настройки блока, в котором даете ссылку на оплату и перейдите в настройки кнопки:

Далее в настройках кнопки найдите чекбокс "Автоплатежи" и активируйте его:

Если вы хотите принимать автоплатежи во всех кнопках на оплату, то включить автоплатежи можно в настройках подключения платежной системы:

**Шаг 2. Провести обычный платёж.**\ \ Далее нужно провести обычный платеж (получить ссылку на оплату и чтоб клиент ее оплатил), как описано выше. После успешного платежа у клиента появится переменная **robokassa\_previous\_invoice\_id** с идентификатором платежа. {% hint style="warning" %} Переменная **robokassa\_previous\_invoice\_id** обязательна для последующих платежей.\ \ Если ее удалить, следующий автоплатеж провести НЕ получится. {% endhint %} {% hint style="danger" %} Обращаем внимание! **Отключите** чекбокс "**Платежи в тестовом режиме**" (если он у вас активный), иначе переменная robokassa\_previous\_invoice\_id с идентификатором платежа не будет сформирована! ![](https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F6OI36u2pDK3DEc4VQEsT%2Fimage.png?alt=media\&token=e6108929-dc3c-498a-948d-12cb203bdef8) {% endhint %}

Пример формирования ссылки для обычного платежа

![](https://lh4.googleusercontent.com/FGVcl0wzMK3_ldq7OxHe3653Q3buEgR29657HixPQ6xUrqoa2E2TpG3yCRdF5oDgj69VhnQRlZJZG_wjnnwQyIjkHRTQ8nr-Jzwyo99CtaiOT5JUuiMLuE2Jm3MDTBxKXJoD02gr=s0) **Шаг 3. Планируем автосписание** От блока Успешная оплата планируем стрелку с таймером к блоку с автоплатежом. Для примера запланируем следующий платеж через 30 дней.

Чтобы прошёл автоплатеж в нужном блоке в поле Калькулятор, нужно добавить вызов функции **robokassa\_recurrent\_payment**, передав в неё параметры в указанном порядке: 1. **payment\_amount** - сумма к оплате (стоимость товара в рублях) 2. **description** - наименование товара. В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания. Максимальная длина — 100 символов. Эта информация отображается в интерфейсе Robokassa и в Электронной квитанции, которую получает клиент после успешного платежа. 3. **country** - доменная зона (‘ru’ или ‘kz’) 4. **products\_for\_receipt** - параметры для формирования чеков. {% hint style="info" %} Подробнее в разделе "Как сформировать запрос на фискализацию -> [Для функций get\_robokassa\_payment\_url и robokassa\_recurrent\_payment](#dlya-funkcii-get_robokassa_payment_url-i-robokassa_recurrent_payment) {% endhint %} 5. **taxation** - система налогообложения. {% hint style="info" %} Подробнее в разделе "Как сформировать запрос на фискализацию -> [Для функций get\_robokassa\_payment\_url и robokassa\_recurrent\_payment](#dlya-funkcii-get_robokassa_payment_url-i-robokassa_recurrent_payment) {% endhint %} Пример запроса на автоплатеж:

{% hint style="warning" %} При выполнении автоплатежа не должно быть ссылки на оплату робокассы и переменной **payment\_sum**! {% endhint %} *Шаг 4. Планируем регулярные списания и настраиваем возможность отказаться от автоплатежей.*\ \ Для регулярного повтора платежей планируем петлю - стрелку с задержкой, например, 30 дней.

Петля - повторный переход в блок Автоплатёж

Если у вас предусмотрена возможность отмены автоплатежей, то для того, чтобы следующий платеж не был выполнен необходимо удалить у клиента переменную `robokassa_previous_invoice_id`\ \ Для этого в поле Калькулятор удаляем переменную:\ \ `robokassa_previous_invoice_id = ""`

### Обычный платеж при включенных автоплатежах Если включены автоплатежи, но нужна ссылка без подписки (без автоплатежей), то до формирования ссылки нужно задать переменную robokassa\_manual\_recurrent\_disable со значением 1\ \ В поле Калькулятор объявим переменную:\ `robokassa_manual_recurrent_disable = 1`

Настройки блока для формирования ссылки на обычный платеж при включенных Автоплатежах

{% hint style="info" %} Внимание! Коллбэк при автоплатежах идентичен коллбэку, который приходит при успешных оплатах. Как настроить реакцию на коллбэк, рассказали в разделе "[Как обработать результат](#kak-obrabotat-rezultat)" {% endhint %} ## Какие требования сервиса Robokassa к чат-ботам Официальный ответ сервиса Robokassa: > Вы можете разместить товар на маркете с описанием и ценником и принимать оплату в боте, можете сделать одностраничник с описанием, ценником, контактными данными и указанием, что доставка товара/оказания услуги электронное. У нас должна быть привязка к товару на маркете или к сайту, т.к. что Вы продаете продает в своем боте и в каком боте мы - мы не можем знать. > > Ссылку на телеграммы канал в качестве URL мы не включаем. Также требования к наполнению сайта: "Сайт должен быть функционирующий, с заполненным контентом, работающими внутренними ссылками. > > Товары и услуги на Вашем сайте должны быть подробно описаны: Описание должно включать характеристики предлагаемых товаров и услуг, их потребительские свойства и актуальную цену. > > На Вашем сайте обязательно должна быть размещена актуальная информация: телефон, e-mail, правила оформления и сроки исполнения заказа, условия его оплаты, доставки и возврата. > > Каждый сайт рассматривается индивидуально. > > С уважением, ROBOKASSA.

## Robokassa в Telegram ### Подключение платежей в Telegram Данный раздел рассмотрен [тут](https://docs.salebot.pro/integracii/platezhnye-sistemy/broken-reference) ### Подключение тестового бота RobokassaPaymentTestBot. 1. При выборе Connect Robokassa Test пользователь переходит в бота RobokassaPaymentTestBot. 2. Пользователь нажимает кнопку /начать. 3. Пользователь получает ответ от бота «Введите ID магазина”. 4. Необходимо ввести id от магазина в сервисе Robokassa. 5. Бот попросит подтверждение, подтверждающее владение магазином посредством отправки смс на номер, указанный в магазине: «Отправлена СМС на номер \*%%%%» где %%%% - последние 4 цифры телефона 6. Пользователь вводит 6-значный код. 7. Если все успешно то пользователю покажется сообщение: “Вы успешно подключили бота @BotName к Robokassa. @BotFather сообщит Вам новый токен.” 8. После этого в BotFather появляется платежный токен, к которому подключаются платежи. ### Подключение live- бота RobokassaPaymentBot. 1. При выборе Connect Robokassa Live пользователь переходит в бота RobokassaPaymentBot, 2. Пользователь нажимает кнопку /начать. 3. Пользователь получает ответ от бота «Введите ID магазина”. 4. Необходимо ввести id от магазина в сервисе Robokassa. 5. Бот попросит подтверждение, подтверждающее владение магазином посредством отправки смс на номер, указанный в магазине: «Отправлена СМС на номер \*%%%%», где %%%% - последние 4 цифры телефона 6. Пользователь вводит 6-значный код. 7. Если все успешно то пользователю покажется сообщение: “Вы успешно подключили бота @BotName к Robokassa. @BotFather сообщит Вам новый токен.” 8. После этого в BotFather появляется платежный токен, к которому подключаются платежи. Обработка результатов оплаты аналогична описанному [тут](#kak-poluchit-uvedomlenie-o-rezultate-oplaty)