Настройка возврата платежа через эквайринг

Возврат денег покупателю в 1С-Битрикс — это не ручной перевод в личном кабинете банка, а операция прямо из карточки заказа, которую платёжная система выполняет через API эквайринга. Разберём, какие эквайринги это поддерживают, как включить возврат в настройках и как корректно оформить полный и частичный возврат с фискальным чеком.

Как устроен возврат в модуле «Интернет-магазин»

Возврат платежа в Битрикс — это отдельная операция над объектом Payment (оплата заказа), а не над самим заказом. Когда покупатель оплатил картой, у оплаты выставлен признак «оплачено» (PAID = Y), и модуль sale хранит идентификатор транзакции в поле PS_INVOICE_ID. Именно этот идентификатор нужен, чтобы попросить эквайринг вернуть списанные средства на ту же карту.

Возврат инициируется из административной части: Магазин → Заказы → карточка заказа → блок «Оплата». Битрикс вызывает метод refund() обработчика платёжной системы, тот формирует запрос к API банка, а после успешного ответа помечает оплату как возвращённую и делает запись в журнале транзакций.

Какие эквайринги поддерживают возврат из коробки

Автоматический возврат работает только с теми платёжными системами, чей обработчик реализует интерфейс возврата. В стандартной поставке обработчики лежат в /bitrix/modules/sale/handlers/paysystem/. Поддержка возврата определяется методом isRefundableExtended() сервиса платёжной системы — если он возвращает true, в карточке оплаты появится кнопка возврата.

Если нужного банка нет в списке или используется самописный обработчик, возврат придётся либо доработать в методе refund(), либо выполнять вручную в личном кабинете банка, а в Битрикс отражать статус отдельно.

Настройка платёжной системы для возврата

Сама возможность вернуть деньги через API часто требует отдельных прав и ключей, отличных от приёма платежей. Проверьте несколько моментов до первого возврата.

• Права на возврат в кабинете банка. В ЮKassa за возвраты отвечает роль, а операция списывается с баланса магазина — если баланс пуст, API вернёт ошибку недостатка средств.
• Секретный ключ / токен. В настройках платёжной системы (Магазин → Настройки → Платёжные системы) должны быть заполнены боевые Shop ID и секретный ключ, у Тинькофф — Terminal Key и Password. По тестовым ключам возврат не пройдёт для реальной транзакции.
• Актуальный обработчик. Обновляйте модуль sale: методы возврата у банков меняются, а старые обработчики могут не знать о новых полях API.

Как оформить возврат в админке

Порядок действий для стандартного полного возврата выглядит так.

1. Откройте Магазин → Заказы и перейдите в нужный заказ.
2. В блоке «Оплата» найдите оплаченную транзакцию и нажмите действие возврата (в разных версиях — «Вернуть деньги» или «Возврат оплаты»).
3. Укажите сумму: по умолчанию подставляется полная сумма оплаты, для частичного возврата её можно уменьшить.
4. Подтвердите операцию. Битрикс отправит запрос эквайрингу и дождётся ответа.
5. При успехе оплата получит признак возврата, а в журнале транзакций заказа появится запись с суммой и датой.

Отдельно обратите внимание на статус самого заказа. Возврат оплаты не отменяет заказ автоматически — при необходимости переведите заказ в статус отмены и снимите резерв товара, иначе позиции останутся «зарезервированными» на складе.

Частичный возврат и фискализация

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

Если магазин работает по 54-ФЗ и пробивает чеки, на каждый возврат нужен отдельный фискальный документ — чек «Возврат прихода». В Битрикс за это отвечает модуль кассы: при подключённой онлайн-кассе (АТОЛ Онлайн, Orange Data, ОФД-провайдер) возврат оплаты автоматически ставит в очередь чек коррекции. Проверьте, что в настройках кассы включена фискализация возвратов.

Типичные ошибки и как их читать

Большинство сбоев при возврате связано не с самим Битриксом, а с ответом банка, который модуль показывает в журнале транзакций. Что встречается чаще всего:

• Недостаточно средств на балансе. Возврат списывается с текущего баланса магазина в эквайринге — пополните его и повторите операцию.
• Транзакция не найдена. Пустой или неверный PS_INVOICE_ID: оплата не была проведена онлайн либо помечена оплаченной вручную.
• Истёк срок возврата. Прошло больше допустимого по договору периода — возврат только офлайн.
• Неверные ключи или права. Секретный ключ не соответствует боевому магазину, либо у учётной записи нет права на операцию возврата.

Полезно временно включить логирование платёжной системы — тело запроса и ответа API сохранится в файле лога, и причина отказа станет очевидна.

Итог

Возврат через эквайринг в 1С-Битрикс — это операция над оплатой в карточке заказа, которую платёжная система выполняет по API банка. Для корректной работы нужны три вещи: обработчик с поддержкой возврата, боевые ключи с правом на возврат и достаточный баланс в эквайринге. Отдельно продумайте фискализацию по 54-ФЗ и синхронизацию статусов с 1С, чтобы деньги, склад и учёт сходились.

Если возвраты идут потоком, нужен нестандартный эквайринг или возврат по инициативе из 1С — мы поможем доработать обработчик платёжной системы, настроить чеки коррекции и обмен статусами. Обращайтесь: наши интеграторы отладят весь цикл оплаты и возврата в вашем магазине.