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

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

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

Операции, которые двигают деньги (подтвердить или отменить холд, повторно списать по подписке, оформить возврат), агент выполняет только после вашего согласия на конкретный вызов, а итог проверяет статусом операции. Зачисление и вывод остаются на стороне Robokassa и вашего договора с ней. По расписанию он обходит выставленные им же счета и напоминает о неоплаченных. Выписки по расчётному счёту здесь нет и быть не может: Robokassa отвечает за приём платежей от клиентов, банк подключается отдельным коннектором.

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