Robokassa

Приложение Robokassa создаёт подписанные ссылки на оплату и проверяет состояние платежа по номеру счёта. Оно подходит для выставления ссылки клиенту из чата, заказа или документа без передачи платёжных паролей агенту.

Подключение

Для интеграции нужны три значения из технических настроек магазина:

• MerchantLogin — идентификатор магазина;
• Пароль №1 — используется для подписи платёжной ссылки;
• Пароль №2 — используется для проверки состояния операции.

Порядок подключения:

1. Откройте технические настройки магазина Robokassa и сверьтесь с документацией платёжного интерфейса.
2. Скопируйте MerchantLogin, Пароль №1 и Пароль №2.
3. В Promto откройте приложение Robokassa и нажмите Подключить.
4. Введите три значения и сохраните подключение.
5. Дождитесь проверки Пароля №2 безопасным запросом состояния.

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

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

Интерфейс приложения

На главном экране есть два сценария:

Сценарий	Что потребуется
Создать ссылку на оплату	Сумма, описание, email покупателя и, при необходимости, состав чека для 54-ФЗ
Проверить оплату	InvId выставленного счёта

Карточка сценария прикрепляет готовое задание к чату. В Настройках видны MerchantLogin, маски паролей, состояние подключения и действие отключения.

Работа с агентом

Основной агент использует инструмент promto_robokassa с двумя действиями:

• create_payment_link — формирует подписанный URL для оплаты;
• check_payment_status — запрашивает фактическое состояние платежа по InvId.

Это встроенный инструмент чата, а не команда терминала. Агент не получает MerchantLogin и пароли в открытом виде: подпись создаёт сервер Promto.

Практические сценарии

Выставить ссылку клиенту

Передайте точную сумму, назначение платежа, уникальный InvId и email. Если магазин использует фискализацию, укажите позиции чека, количество, ставку НДС и способ расчёта. Агент должен показать итоговые параметры и URL до того, как ссылка будет отправлена клиенту через другой канал.

Проверить оплату

Передайте InvId. Агент вызовет check_payment_status, расшифрует код Robokassa и укажет, подтверждена ли операция. Не делайте вывод по факту открытия ссылки или сообщению клиента.

Сверить сумму

Сумма в подписи и сумма в URL должны совпадать до копейки. При повторной проверке используйте тот же InvId и ожидаемую сумму из вашей учётной системы.

Ограничения и безопасность

• Интеграция не списывает деньги, не делает возвраты, не выводит средства и не заменяет банковскую выписку.
• create_payment_link только создаёт ссылку. Статус проверяется отдельным действием.
• Не редактируйте сумму или параметры вручную в готовом URL: подпись перестанет соответствовать запросу.
• Не передавайте пароли в чат, файлы, инструкции рабочего пространства или код проекта.
• Используйте уникальные InvId, чтобы не перепутать разные заказы.
• Email, назначение и состав чека могут содержать персональные или финансовые данные; передавайте только необходимое.
• Числовой код ответа Robokassa нужно расшифровать, а не показывать пользователю без объяснения.

Если не работает

Симптом	Что проверить
Проверка статуса не проходит	MerchantLogin и Пароль №2, а также режим магазина
Платёжная страница отвергает подпись	Пароль №1, точное совпадение суммы и неизменность параметров URL
Статус не найден	Правильность InvId и магазин, в котором он создан
Клиент говорит, что оплатил	Повторить check_payment_status; не считать сообщение подтверждением
Ошибка в чеке	Формат позиций, количества, НДС и обязательные поля фискализации

Связанные материалы

• Настройки рабочего пространства
• Telegram — отправка согласованной ссылки клиенту
• Как получать лучший результат

Готовый промпт

Через promto_robokassa подготовь ссылку на оплату: InvId <НОМЕР>, сумма <СУММА> RUB, назначение <ОПИСАНИЕ>, email <EMAIL>. Сначала покажи все параметры и проверь сумму до копейки. Создай ссылку, но никуда её не отправляй. Отдельно напомни, что оплату нужно подтвердить через check_payment_status по тому же InvId.