Выставляйте ссылки на оплату Robokassa прямо в переписке

Агент работает с Robokassa через подписанные запросы к auth.robokassa.ru: собирает ссылку на оплату с суммой, описанием заказа и фискальным чеком по 54-ФЗ, читает статус выставленного счёта по его номеру и показывает валюты и способы оплаты, доступные конкретно вашему магазину. Проверочный запрос при подключении — список валют магазина: он же сразу показывает, что подпись сходится и магазин отвечает.

Токена в Robokassa нет — доступ держится на паролях магазина, и они не равнозначны: пароль #1 подписывает сам платёж, пароль #2 — уведомления и проверку статуса. Поэтому агенту нужны оба, иначе половина работы отвалится. Сама подпись собирается из идентификатора магазина, суммы, номера счёта и пароля и считается по MD5, поэтому сумма в подписи и сумма в ссылке обязаны совпадать до копейки — иначе платёж отклоняется на входе, ещё до страницы оплаты.

Деньгами агент не распоряжается: он выставляет счёт и читает его статус — инициирован, в холде, оплачен или возвращён, — а зачисление и вывод остаются на стороне Robokassa и вашего договора с ней. По расписанию он обходит выставленные им же счета и напоминает о неоплаченных. Выписки по расчётному счёту здесь нет и быть не может: Robokassa — это приём платежей от клиентов, банк подключается отдельным коннектором.

Ошибки Robokassa возвращает числовым кодом, и агент расшифровывает его, а не показывает «запрос не прошёл»: по коду видно, разошлась ли подпись, не активирован ли магазин или такого счёта попросту нет. Частоту запросов он выдерживает сам — до пяти в секунду с небольшим запасом на всплеск, — так что серия проверок статуса не упирается в отказ. Если по счёту данных нет или магазин их не отдаёт, агент говорит об этом прямо, а не показывает пустую таблицу.