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

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

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

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

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

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

   <figure><img src="/files/hXKBXYM9kcs1vAv2Pumb" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

<figure><img src="/files/ECPSLc1Btl8cQil4fQHT" 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="/files/IdvCJo15b0GW9rzv0dnu" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/LAANqiCSRF7ztUB9sk8Y" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/BAaX86kiGV2yyzIcjnE2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3MNnZivFumJMaiuSCSmb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/6VvFnSg0e8eZQ1iq7ZnT" alt=""><figcaption></figcaption></figure>

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

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

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


---

# 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://doc.nextbot.ru/functional/integrations/robokassa/bystryi-gaid-dlya-podklyucheniya-i-proverki-robokassa.md?ask=<question>
```

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.
