Платежи через Робокассу: прием, статусы, уведомления и возвраты

Table of contents

• Архитектура платежного процесса
• Способы оплаты и их особенности
• Статусы платежей: от инициации до зачисления
• Уведомления мерчанта: серверные и клиентские
• Webhooks: прием и валидация
• Возвраты (полные и частичные)
• Частые ошибки и способы их устранения
• Антифрод и безопасность
• Отчеты, сверка и бухгалтерия

Архитектура платежного процесса

Платеж через Робокассу обычно включает шаги: инициация (создание заказа) → выбор способа оплаты (виджет/редирект) → авторизация у провайдера → подтверждение/клиринг → уведомление мерчанта → выдача товара/услуги → фискализация чека. Корректная обработка каждого шага снижает долю брошенных оплат и спорных ситуаций.

Способы оплаты и их особенности

• Банковские карты: высокая конверсия, поддержка 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 до запуска рекламы.