Возвраты в YooKassa: полные и частичные, сроки, статусы и учёт
Возврат — стандартная операция в электронной коммерции: товар не подошёл, заказ отменён, услуга не оказана полностью, покупатель передумал. Эта страница — ваша подробная инструкция по теме «возврат платежа YooKassa»: разберём типы возвратов, сроки зачисления денег, статусы и требования к учёту, а также покажем, как сделать возврат в личном кабинете и через API v3.
Table of contents
Когда используется возврат и чем он отличается от отмены
Важно отличать две операции:
- Отмена (cancel) — применяется, когда платёж ещё не был списан окончательно. Например, если у платежа статус «ожидает подтверждения/списания», вы можете отменить его без проведения возврата.
- Возврат (refund) — применяется к уже успешному платёжному списанию. Деньги отправляются покупателю тем же способом, которым он платил.
Схематично процесс выглядит так:
![Схема процесса возврата: оплата → подтверждение → возврат полностью или частично]
Полезные материалы по статусам и жизненному циклу платежей:
Полный и частичный возврат: правила и ограничения
Частичный возврат YooKassa позволяет вернуть только часть суммы заказа — удобный сценарий при частичной отмене товаров, корректировке доставки или скидках постфактум. Полный — возвращает всю сумму платежа.
Ключевые правила:
- Возвраты возможны только по успешным платежам и тем же способом, которым платил клиент.
- Вы можете оформить несколько частичных возвратов, пока не вернёте всю сумму.
- Комиссия эквайринга удерживается по условиям вашего договора; как правило, комиссия за исходный платёж не возвращается.
- Для некоторых способов оплаты могут действовать ограничения (например, требования к срокам или невозможность возврата комиссий/чаевых). Проверяйте условия подключения и документацию по способам оплаты в вашем договоре.
Сравнение типов возвратов:
| Тип операции |
Когда применять |
Сумма |
Ограничения |
| Полный возврат |
Заказ отменён целиком |
100% суммы |
Разрешён для большинства способов оплаты |
| Частичный возврат |
Возврат отдельных позиций/части услуги |
Любая часть суммы до 100% |
Частота и минимальные суммы могут зависеть от способа |
Если вы выставляете счета или отправляете ссылки на оплату, оформлять возвраты по таким платежам можно теми же способами: через личный кабинет или API. Подробнее о счётах — в разделе Ссылки на оплату и счета.
Сроки возврата YooKassa по способам оплаты
Покупателям важно знать, когда они увидят деньги на счёте. Ниже — ориентировочные сроки возврата YooKassa. Фактическая скорость зависит от банка-эмитента, платёжной системы и загруженности платёжной инфраструктуры.
| Способ оплаты |
Ориентировочный срок зачисления |
Примечания |
| Банковские карты (Visa, Mastercard, Мир), в том числе Apple Pay/Google Pay |
От нескольких минут до 7 рабочих дней (иногда до 30 календарных дней) |
Apple Pay/Google Pay идут по rails карты, сроки те же |
| СБП (Система быстрых платежей) |
Мгновенно — 24 часа |
В большинстве случаев деньги приходят в течение минут |
| ЮMoney кошелёк |
Мгновенно или в течение часа |
Обычно зачисление происходит сразу |
| Интернет-банки/локальные методы |
От нескольких минут до 3 рабочих дней |
Зависит от канала и банка |
Совет для поддержки клиентов: заранее сообщайте ориентиры и предлагаете ссылку на самопроверку статуса платежа — раздел Мои платежи. Это снизит нагрузку на поддержку и повысит доверие.
Как сделать возврат в личном кабинете
Самый быстрый способ оформить возврат — в ЛК YooKassa. Это особенно удобно, если вы не автоматизировали процесс через API.
Шаги:
- Зайдите во вход в личный кабинет. Если возникают сложности с авторизацией — посмотрите раздел Проблемы со входом.
- Откройте список платежей и найдите нужный. Возможности поиска, фильтры и карточка платежа описаны в разделе Личный кабинет: возможности.
- В карточке платежа нажмите «Возврат».
- Укажите сумму (для частичного возврата — часть суммы), при необходимости — комментарий для клиента и позиционный состав для фискального чека возврата.
- Подтвердите операцию. В карточке появится запись о созданном возврате и его статус.
Подсказки:
- Если платёж ещё «ожидает подтверждения», вместо возврата используйте отмену. Это быстрее для клиента и прозрачнее в учёте.
- Для частичных возвратов проверяйте корректность фискальных позиций — они должны соответствовать возвращаемой части заказа.
Возврат через API v3 (Refund API YooKassa)
Для автоматизации используйте Refund API YooKassa в составе API v3.
Базовый сценарий:
- Создайте объект возврата для успешного платежа.
- Передайте идентификатор платежа, сумму и (при необходимости) позиции чека возврата.
- Используйте идемпотентность, чтобы не создать дубли при повторах.
Ключевые параметры запроса:
- payment_id — ID исходного платежа;
- amount.value и amount.currency — сумма и валюта возврата;
- description — комментарий для журнала операций;
- receipt — позиции для фискального чека типа «возврат прихода» (если вы фискализируете через YooKassa);
- Idempotence-Key — уникальный ключ запроса.
Полезно разработчикам:
Эти материалы помогут быстро внедрить «refund api yookassa» и покрыть кейсы полного и частичного возврата.
Статусы платежей и возвратов: как отслеживать
Понимание статусов помогает правильно выстраивать уведомления и бухгалтерию.
Для платежей ключевые состояния описаны в разделе Статусы платежей. Для возвратов встречаются такие статусы:
- pending — возврат создан, обработка началась;
- succeeded — возврат выполнен, средства отправлены клиенту;
- canceled — возврат отменён (например, по таймауту или из‑за ошибки параметров).
Где смотреть:
- Личный кабинет — в карточке платежа видны все связанные возвраты и их статусы.
- API — получайте объект возврата по его ID или подписывайтесь на вебхуки, чтобы обрабатывать статусы асинхронно.
Совет: показывайте клиенту понятные статусы в его личном кабинете/профиле, а для самопроверки давайте ссылку на Мои платежи.
Фискализация и учёт возвратов по 54-ФЗ
Если вы фискализируете через YooKassa, мы формируем чек типа «возврат прихода». Важно корректно передавать состав позиций, ставки НДС и признаки предмета расчёта.
Памятка бухгалтеру:
- Полный возврат — чек «возврат прихода» на всю сумму;
- Частичный возврат — чек «возврат прихода» на часть позиций или их часть, пропорционально суммы возврата;
- Исправления по прошлым периодам — используйте механизм корректировок согласно вашему кассовому решению;
- Экспорт данных — выгружайте реестры платежей и возвратов из ЛК или по API для сверок.
Если вы используете внешнюю кассу/ОФД, убедитесь, что интеграция настроена на передачу корректных чеков возврата. О безопасности обработки платежей читайте в разделе Безопасность платежей.
Частые вопросы и советы
- Клиенту придут деньги туда же, откуда он платил? Да, возврат выполняется в исходный платёжный инструмент.
- Что если карта клиента перевыпущена или закрыта? Банк обычно зачисляет на новый счёт/карту того же клиента. Срок может увеличиться.
- Сколько занимает возврат? Смотрите раздел о сроках выше — для карт обычно от минут до 7 рабочих дней; иногда до 30 календарных дней из‑за внутренних процедур банка.
- Можно ли сделать несколько частичных возвратов? Да, до полной суммы платежа.
- Комиссия возвращается? Как правило, комиссия за исходный платёж остаётся у провайдера по условиям договора. Уточните условия вашего тарифа.
- Где клиент может проверить статус? Дайте ссылку на Мои платежи и укажите ID транзакции.
- Можно ли делать возвраты по счетам и ссылкам на оплату? Да, сценарии одинаковы. Подробнее — Ссылки на оплату и счета.
Про процессы оплаты на сайтах и подтверждение платёжных сценариев читайте также в материале Оплата на сайтах.
Безопасность и диагностика проблем
- Проверяйте домены: операции проводите только в официальном ЛК и по проверенным интеграциям. Подробнее — Домены и зеркала.
- Ограничьте права пользователей ЛК и используйте двухфакторную аутентификацию. Больше — в разделе Безопасность платежей.
- Если не получается зайти в ЛК — загляните в Проблемы со входом.
- При зависшем статусе возврата проверьте: наличие ответа по вебхуку, журнал событий в ЛК, параметры чека возврата (особенно при частичных возвратах), корректность Idempotence-Key и признаки повторов.
Иллюстрация контроля операций:
![Дашборд YooKassa: фильтры, статусы, операции возврата]
Итоги и что делать дальше
Возвраты — естественная часть клиентского сервиса. Главное — выстроить понятные правила: когда делать отмену, когда — полный или частичный возврат; заранее объяснять клиенту сроки; корректно фискализировать и вести учёт.
Что дальше:
Готовы улучшить клиентский сервис? Настройте сценарии «полный и частичный возврат YooKassa» сегодня — так вы сэкономите время поддержки, повысите лояльность покупателей и упростите бухгалтерию.