Платежи через Робокассу: прием, статусы, уведомления и возвраты
Архитектура платежного процесса
Платеж через Робокассу обычно включает шаги: инициация (создание заказа) → выбор способа оплаты (виджет/редирект) → авторизация у провайдера → подтверждение/клиринг → уведомление мерчанта → выдача товара/услуги → фискализация чека. Корректная обработка каждого шага снижает долю брошенных оплат и спорных ситуаций.
Способы оплаты и их особенности
- Банковские карты: высокая конверсия, поддержка 3‑D Secure.
- Быстрые платежи: моментальные переводы, низкая комиссия в ряде случаев.
- Альтернативные методы: электронные кошельки, счета‑фактуры — зависят от включенных опций.
При выборе способов учитывайте целевую аудиторию и средний чек. Для B2B добавьте безнал с выставлением счета, для импульсных покупок — быстрые способы оплаты.
Статусы платежей: от инициации до зачисления
| Статус |
Описание |
Действие мерчанта |
| created/init |
Заказ создан, оплаты еще нет |
Ждем действия клиента |
| pending |
Клиент на шаге оплаты |
Ненавязчивое напоминание |
| success/paid |
Оплата подтверждена |
Выдать товар, выбить чек |
| failed/declined |
Отказ банка/покупателя |
Предложить другой метод |
| refund |
Возврат исполнен |
Отправить чек возврата |
Важно: опирайтесь на серверное подтверждение (webhook), а не только на редирект клиента.
Уведомления мерчанта: серверные и клиентские
- Клиентские: редирект/скрипт на странице успеха — подходят для UX, но небезопасны для финальной логики.
- Серверные (webhooks): подтверждают платеж независимо от действий клиента. Настройте резервный endpoint и подписи запросов.
Webhooks: прием и валидация
- Принимайте POST‑запросы на выделенный URL.
- Проверяйте подпись/секрет, сверяйте суммы и валюты.
- Отвечайте 200 OK только после успешной обработки.
- Логируйте payload и время ответа, внедрите повторные попытки с идемпотентностью.
Пример полей, которые полезно хранить: order_id, payment_id, сумма, валюта, статус, подпись, timestamp.
Возвраты (полные и частичные)
Возврат выполняется из личного кабинета или по API. Перед возвратом убедитесь, что платеж действительно зачислен и не находится в холде. Для частичного возврата корректно пересчитайте номенклатуру и НДС, сформируйте чек возврата прихода. Сообщите клиенту сроки зачисления: у банков это может занимать 1–10 рабочих дней.
Частые ошибки и способы их устранения
- Несоответствие суммы: убедитесь, что на стороне сервера сумма передается в точности, без округлений на фронте.
- Дубли платежей: используйте идемпотентные ключи/номер заказа и проверку статуса перед повторной инициацией.
- Падение конверсии: проверьте скорость загрузки страницы оплаты, корректность 3‑D Secure, добавьте альтернативные методы.
Антифрод и безопасность
Включите строгие проверки, лимиты по суммам/частоте, географические фильтры, black/white‑листы. Регулярно анализируйте chargeback‑отчеты и корректируйте правила.
Отчеты, сверка и бухгалтерия
Используйте раздел отчётности в ЛК для сверки с 1С/бухгалтерией. Автоматизируйте выгрузки (CSV/JSON) и настраивайте регулярные акты. Не забывайте сопоставлять успешные платежи с чеками и отгрузками.
— Готовы к интеграции? Перейдите к разделу «Подключить Робокассу» и настройте webhooks до запуска рекламы.
