# Быстрый гайд для подключения и проверки Robokassa

Настоящее руководство представляет собой краткую пошаговую инструкцию, охватывающую весь цикл внедрения: подключение интеграции с Робокассой, конфигурацию прайс-листа, создание Функции через Мастер, тестирование функционала и запуск в production-режиме.

Если вам требуется более подробная информация о настройке интеграции и Функций, ознакомьтесь со следующими материалами:

* [Подключение Robokassa](https://doc.nextbot.ru/functional/integrations/robokassa/podklyuchenie-robokassa)
* [Функции для работы с Robokassa](https://doc.nextbot.ru/functional/integrations/robokassa/funkcii-dlya-raboty-s-robokassa)

<h2 align="center">Подключение интеграции Robokassa</h2>

1. Убедитесь, что личный кабинет Робокассы настроен и Магазин создан
2. Перейдите в раздел Интеграции → Robokassa
3. Запустите Мастер подключения и следуйте пошаговым инструкциям, читая подсказки
4. (Опционально) Для тестирования перед запуском выберите в Мастере тестовый режим и укажите два тестовых пароля
5. На десятом шаге Мастера вам будет предложено создать прайс-лист. Инструкция по заполнению представлена ниже<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FliacgIFYIQ0Wt2jHAIim%2Fimage.png?alt=media&#x26;token=273ad02e-c4c1-4c52-baf5-ce9677121164" alt=""><figcaption></figcaption></figure>

<h2 align="center">Конфигурация и добавление прайс-листа</h2>

Настройте прайс-лист на шаге 10 Мастера подключения или на главной странице интеграции Robokassa.

Для добавления позиции нажмите «Новая позиция» и заполните:

* Название (уникальное)
* Цена (от 1 до 5 000 000)

{% hint style="warning" %}
⚠️ Будьте внимательны: позиция не будет добавлена при некорректном заполнении обязательных полей!
{% endhint %}

Прайс-лист обеспечивает ИИ-агента данными о товарах и ценах для генерации чеков. Логика работы определяется двумя факторами:

* Тип подгрузки данных (в параметры Функции, в промпт или через внешний источник)
* Количество позиций в одном чеке

Настройка способов подгрузки прайс-листа описана в следующем разделе.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FJwvRARLeA0TEb0dha43q%2Fimage.png?alt=media&#x26;token=5da25708-5870-4390-abd3-d3af53c1109a" alt=""><figcaption></figcaption></figure>

<h2 align="center">Создание Функции через Мастер содания функций</h2>

По завершении подключения интеграции и формирования прайс-листа необходимо создать Функцию для обработки платежей.

{% hint style="warning" %}
⚠️Для формирования функции крайне рекомендуется использовать Мастер создания функций, поскольку самостоятельная настройка параметров может привести к некорректной работе интеграции.
{% endhint %}

1. Откройте «Интеграции» → Robokassa и нажмите «Мастер создания функций»
2. Следуйте пошаговым инструкциям, внимательно читая подсказки
3. **Шаг 2:** Определите количество позиций в чеке — одна или нескольк
4. **Шаг 3:** Выберите способ подгрузки прайс-листа:
   * **В промпт** — прайс-лист обновляется автоматически при любых изменениях
   * **В параметры Функции** — требуется пересоздание Функции при изменении цен
   * **Без подгрузки** — ИИ-агент использует цены из других источников (промпт, YClients и др.), но при формировании чека позиции сверяются с прайс-листом
5. **Дополнительные настройки:**

   * Должен ли ИИ-агент запрашивать количество товара (или всегда использовать «1»)
   * Должен ли ИИ-агент запрашивать e-mail клиента перед формированием чека

   \
   После завершения Мастера Функция `generate_payment_link` будет создана и готова к тестированию. Переходите к следующему этапу.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FQlnKFc38qa81EcwU2pZD%2Fimage.png?alt=media&#x26;token=bd4c35d0-2861-41fe-9e83-c73b68532f7b" alt=""><figcaption></figcaption></figure>

<h2 align="center">Тестирование и отладка работы Robokassa</h2>

Чтобы изменить режим работы интеграции (тестовый/рабочий), используйте переключатель на главной странице интеграции.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FHaL2kvlg9MVHNEjB6j7C%2Fimage.png?alt=media&#x26;token=6c0cf1e1-f8c0-4375-b17a-a40a968a1407" alt=""><figcaption></figcaption></figure>

Тестовый режим позволяет безопасно проверить работу интеграции без реальных транзакций.

Для его использования сначала сгенерируйте тестовые пароли в разделе «Технические настройки» кабинета Робокассы, затем укажите эти пароли в настройках интеграции Nextbot.

После этого перейдите в тестовый чат и от лица клиента попросите ИИ-агента сформировать чек на услугу\товар. Агент создаст платежную ссылку и отправит её в чат — перейдите по ссылке для завершения тестового платежа.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F5vbhAhdq04OeqolEDm7s%2Fimage.png?alt=media&#x26;token=13eed51a-ec83-45b0-9de1-4d3143c533de" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FxBrNytiRr1VzTMH7O0Ro%2Fimage.png?alt=media&#x26;token=131635e0-321f-4f5f-a43c-bcbab86a2fa8" alt=""><figcaption></figcaption></figure>

\
Чтобы завершить тестовый платеж, выберите «Успешно». Система перенаправит вас на страницу успешной оплаты, указанную в настройках интеграции.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fn1E9BqZ57GzTfGrxVu7G%2Fimage.png?alt=media&#x26;token=97a3bb84-62ba-4df5-8d5c-86d68479adf1" alt=""><figcaption></figcaption></figure>

<h2 align="center">Финальный запуск Robokassa</h2>

После завершения всех тестов и проверки работы интеграции переключите режим работы с помощью переключателя Тестовый режим Robokassa на главной странице интеграции.

С этого момента ИИ-агент будет генерировать чеки для реальных платежей.