Возвраты в YooKassa: полные и частичные, сроки, статусы и учёт

Возвраты в YooKassa: полные и частичные, сроки, статусы и учёт

Возврат — стандартная операция в электронной коммерции: товар не подошёл, заказ отменён, услуга не оказана полностью, покупатель передумал. Эта страница — ваша подробная инструкция по теме «возврат платежа YooKassa»: разберём типы возвратов, сроки зачисления денег, статусы и требования к учёту, а также покажем, как сделать возврат в личном кабинете и через API v3.

---

Когда используется возврат и чем он отличается от отмены

Важно отличать две операции:

• Отмена (cancel) — применяется, когда платёж ещё не был списан окончательно. Например, если у платежа статус «ожидает подтверждения/списания», вы можете отменить его без проведения возврата.
• Возврат (refund) — применяется к уже успешному платёжному списанию. Деньги отправляются покупателю тем же способом, которым он платил.

Схематично процесс выглядит так:

![Схема процесса возврата: оплата → подтверждение → возврат полностью или частично]

Полезные материалы по статусам и жизненному циклу платежей:

• Как устроены статусы — смотрите раздел Статусы платежей.
• Обзор приёма платежей и подтверждения — в статье API v3: обзор и Payments API v3.

Полный и частичный возврат: правила и ограничения

Частичный возврат YooKassa позволяет вернуть только часть суммы заказа — удобный сценарий при частичной отмене товаров, корректировке доставки или скидках постфактум. Полный — возвращает всю сумму платежа.

Ключевые правила:

• Возвраты возможны только по успешным платежам и тем же способом, которым платил клиент.
• Вы можете оформить несколько частичных возвратов, пока не вернёте всю сумму.
• Комиссия эквайринга удерживается по условиям вашего договора; как правило, комиссия за исходный платёж не возвращается.
• Для некоторых способов оплаты могут действовать ограничения (например, требования к срокам или невозможность возврата комиссий/чаевых). Проверяйте условия подключения и документацию по способам оплаты в вашем договоре.

Сравнение типов возвратов:

Тип операции	Когда применять	Сумма	Ограничения
Полный возврат	Заказ отменён целиком	100% суммы	Разрешён для большинства способов оплаты
Частичный возврат	Возврат отдельных позиций/части услуги	Любая часть суммы до 100%	Частота и минимальные суммы могут зависеть от способа

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

Сроки возврата YooKassa по способам оплаты

Покупателям важно знать, когда они увидят деньги на счёте. Ниже — ориентировочные сроки возврата YooKassa. Фактическая скорость зависит от банка-эмитента, платёжной системы и загруженности платёжной инфраструктуры.

Способ оплаты	Ориентировочный срок зачисления	Примечания
Банковские карты (Visa, Mastercard, Мир), в том числе Apple Pay/Google Pay	От нескольких минут до 7 рабочих дней (иногда до 30 календарных дней)	Apple Pay/Google Pay идут по rails карты, сроки те же
СБП (Система быстрых платежей)	Мгновенно — 24 часа	В большинстве случаев деньги приходят в течение минут
ЮMoney кошелёк	Мгновенно или в течение часа	Обычно зачисление происходит сразу
Интернет-банки/локальные методы	От нескольких минут до 3 рабочих дней	Зависит от канала и банка

Совет для поддержки клиентов: заранее сообщайте ориентиры и предлагаете ссылку на самопроверку статуса платежа — раздел Мои платежи. Это снизит нагрузку на поддержку и повысит доверие.

Как сделать возврат в личном кабинете

Самый быстрый способ оформить возврат — в ЛК YooKassa. Это особенно удобно, если вы не автоматизировали процесс через API.

Шаги:

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

Подсказки:

• Если платёж ещё «ожидает подтверждения», вместо возврата используйте отмену. Это быстрее для клиента и прозрачнее в учёте.
• Для частичных возвратов проверяйте корректность фискальных позиций — они должны соответствовать возвращаемой части заказа.

Возврат через API v3 (Refund API YooKassa)

Для автоматизации используйте Refund API YooKassa в составе API v3.

Базовый сценарий:

• Создайте объект возврата для успешного платежа.
• Передайте идентификатор платежа, сумму и (при необходимости) позиции чека возврата.
• Используйте идемпотентность, чтобы не создать дубли при повторах.

Ключевые параметры запроса:

• payment_id — ID исходного платежа;
• amount.value и amount.currency — сумма и валюта возврата;
• description — комментарий для журнала операций;
• receipt — позиции для фискального чека типа «возврат прихода» (если вы фискализируете через YooKassa);
• Idempotence-Key — уникальный ключ запроса.

Полезно разработчикам:

• Общая архитектура и аутентификация: API v3: обзор
• Работа с платежами и возвратами: Payments API v3

Эти материалы помогут быстро внедрить «refund api yookassa» и покрыть кейсы полного и частичного возврата.

Статусы платежей и возвратов: как отслеживать

Понимание статусов помогает правильно выстраивать уведомления и бухгалтерию.

Для платежей ключевые состояния описаны в разделе Статусы платежей. Для возвратов встречаются такие статусы:

• pending — возврат создан, обработка началась;
• succeeded — возврат выполнен, средства отправлены клиенту;
• canceled — возврат отменён (например, по таймауту или из‑за ошибки параметров).

Где смотреть:

• Личный кабинет — в карточке платежа видны все связанные возвраты и их статусы.
• API — получайте объект возврата по его ID или подписывайтесь на вебхуки, чтобы обрабатывать статусы асинхронно.

Совет: показывайте клиенту понятные статусы в его личном кабинете/профиле, а для самопроверки давайте ссылку на Мои платежи.

Фискализация и учёт возвратов по 54-ФЗ

Если вы фискализируете через YooKassa, мы формируем чек типа «возврат прихода». Важно корректно передавать состав позиций, ставки НДС и признаки предмета расчёта.

Памятка бухгалтеру:

• Полный возврат — чек «возврат прихода» на всю сумму;
• Частичный возврат — чек «возврат прихода» на часть позиций или их часть, пропорционально суммы возврата;
• Исправления по прошлым периодам — используйте механизм корректировок согласно вашему кассовому решению;
• Экспорт данных — выгружайте реестры платежей и возвратов из ЛК или по API для сверок.

Если вы используете внешнюю кассу/ОФД, убедитесь, что интеграция настроена на передачу корректных чеков возврата. О безопасности обработки платежей читайте в разделе Безопасность платежей.

Частые вопросы и советы

• Клиенту придут деньги туда же, откуда он платил? Да, возврат выполняется в исходный платёжный инструмент.
• Что если карта клиента перевыпущена или закрыта? Банк обычно зачисляет на новый счёт/карту того же клиента. Срок может увеличиться.
• Сколько занимает возврат? Смотрите раздел о сроках выше — для карт обычно от минут до 7 рабочих дней; иногда до 30 календарных дней из‑за внутренних процедур банка.
• Можно ли сделать несколько частичных возвратов? Да, до полной суммы платежа.
• Комиссия возвращается? Как правило, комиссия за исходный платёж остаётся у провайдера по условиям договора. Уточните условия вашего тарифа.
• Где клиент может проверить статус? Дайте ссылку на Мои платежи и укажите ID транзакции.
• Можно ли делать возвраты по счетам и ссылкам на оплату? Да, сценарии одинаковы. Подробнее — Ссылки на оплату и счета.

Про процессы оплаты на сайтах и подтверждение платёжных сценариев читайте также в материале Оплата на сайтах.

Безопасность и диагностика проблем

• Проверяйте домены: операции проводите только в официальном ЛК и по проверенным интеграциям. Подробнее — Домены и зеркала.
• Ограничьте права пользователей ЛК и используйте двухфакторную аутентификацию. Больше — в разделе Безопасность платежей.
• Если не получается зайти в ЛК — загляните в Проблемы со входом.
• При зависшем статусе возврата проверьте: наличие ответа по вебхуку, журнал событий в ЛК, параметры чека возврата (особенно при частичных возвратах), корректность Idempotence-Key и признаки повторов.

Иллюстрация контроля операций:

![Дашборд YooKassa: фильтры, статусы, операции возврата]

Итоги и что делать дальше

Возвраты — естественная часть клиентского сервиса. Главное — выстроить понятные правила: когда делать отмену, когда — полный или частичный возврат; заранее объяснять клиенту сроки; корректно фискализировать и вести учёт.

Что дальше:

• Хотите оформить возврат сейчас? Войдите в личный кабинет и найдите платёж в журнале.
• Нужна автоматизация возвратов? Изучайте API v3: обзор и Payments API v3, подключайте refund api yookassa.
• Только планируете работу с YooKassa? Посмотрите, какие есть возможности личного кабинета и убедитесь, что принимаете платежи по безопасным практикам — Безопасность платежей.

Готовы улучшить клиентский сервис? Настройте сценарии «полный и частичный возврат YooKassa» сегодня — так вы сэкономите время поддержки, повысите лояльность покупателей и упростите бухгалтерию.