API ЮKassa
Помощь
Подключить ЮKassa
История платежей
Статистика
В графике над списком платежей — самые главные показатели вашего магазина за выбранный период (его можно поменять):
  • выручка — сумма, которую вы получили за этот период,
  • средний чек — сумма, которая получается, если выручку разделить на количество платежей;
  • сумма всех возвратов
  • и количество успешных платежей.
Если магазин принимает платежи не в рублях, а в другой валюте, выручка отображается в этой валюте. Возвраты всегда показываются в рублях.
График можно убрать, чтобы не мешал (по кнопке Скрыть справа вверху).
История платежей
Список всех платежей находится в личном кабинете в разделе Операции, вкладка Платежи.
В первой колонке:
  • Идентификатор платежа (номер транзакции в нашем сервисе).
  • Иконка статуса доставки чека.
  • Дата и время, когда деньги списаны с покупателя.
Во второй колонке:
  • Описание платежа. Сюда выводится информация, которую вы передадите в ЮKassa при оплате — её покупатель увидит во время оплаты. Это может быть, например, номер заказа, телефон, любое описание. Если вы работаете с ЮKassa по API, описание платежа передаётся в запросе на оплату в поле description.
В третьей колонке:
  • Статус платежа.
  • Дата и время присвоения этого статуса. Например, при статусе Оплачен здесь указана дата и время зачисления денег на ваш счёт.
В четвертой колонке:
  • Сумма платежа.
  • Способ оплаты.
  • Кнопка возврата (для успешных платежей). Она открывает форму для создания заявки на возврат денег покупателю. См. Возвраты
Детали платежа и история операции
Нажмите на платёж, чтобы посмотреть дополнительную информацию — детали платежа и историю операции.
В деталях есть идентификатор платежа — это номер транзакции в ЮKassa.
У платежей с банковских карт появляется RRN — Retrieval Reference Number. Это номер, по которому можно найти информацию о платеже в вашем банке. Ещё по этому номеру можно через фильтр искать платежи с банковских карт.
Для операций, которые сделаны не более 7 дней назад, можно посмотреть Логи.
Под деталями платежа — История операции. Здесь в хронологическом порядке показаны события, связанные с этой операцией: история изменения статуса платежа, данные об отправке чеков в облачную кассу (если вы используете решение ЮKassa для 54-ФЗ). Отсюда можно перейти в просмотр деталей чека.
Статусы доставки чеков:
Чек в обработкеЧек отправлен, но облачная касса ещё не ответила.
Чек не доставлен в облачную кассуОблачная касса не приняла чек (например, из-за технической ошибки). Такой чек нужно сформировать и отправить вручную через личный кабинет онлайн-кассы.
Чек доставлен в облачную кассуОблачная касса приняла чек.
Статусы платежей:
СозданПлатёж создан, но оплаты ещё не было.
ОплаченПлатёж прошел успешно.
Не оплаченПроцесс платежа начат, но не закончен. Деньги не зачислены.
В обработкеПроцесс платежа начат, но не закончен. Например, при платежах с предавторизацией.
Частично возвращёнЧастичный возврат прошёл успешно, часть денег вернулась покупателю.
ВозвращёнПолный возврат прошёл успешно, деньги вернулись покупателю.
ОтменёнДля платежей с предавторизацией: платёж начат, но отменён после первой фазы.
Ошибка оплатыПлатеж не прошел из-за ошибки.
Ожидает подтвержденияДля платежей с предавторизацией: платёж начат, но не подтверждён.
Если платёж прошёл успешно, справа от суммы появляется кнопка Возврат — при нажатии на неё открывается форма для создания заявки на возврат денег покупателю (см. Возвраты). После возврата (полного или частичного) статус платежа поменяется.
Если у вас в магазине включена предавторизация, платёж может перейти в статус Ожидает подтверждения. Подтвердить или отменить такой платёж можно с помощью кнопок Отменить платёж и Подтвердить.
Детали чека
Перейдите в Историю операции и нажмите Посмотреть чек напротив нужного чека. Здесь находятся фискальные данные чека, список товаров и итоговая сумма платежа.
Если чек не доставлен в онлайн-кассу, в деталях указана причина — например, техническая ошибка. Такой чек нужно сформировать и отправить вручную через личный кабинет онлайн-кассы.
Поиск платежей
В истории есть поисковая строка и набор фильтров. Можно найти конкретный платёж или выбрать все платежи, которые подходят по параметрам. По кнопке Найти результаты выводятся в виде списка. Если нужно, список можно скачать (значок загрузки).
По умолчанию в истории видно все платежи за последний месяц.
Поисковая строка
Умеет искать по разным параметрам, но одновременно можно вводить только что-то одно:
  • Описание платежа, которое вы передали в ЮKassa.
  • Номер заказа из вашей системы.
  • RRN — номер, который присваивается платежам с банковских карт. Чтобы найти операцию по RRN, номер нужно запросить у покупателя (есть в чеке и в истории операций в банке покупателя).
  • Номер банковской карты. Можно указать последние 4 цифры, но если платежей с карт много, могут быть совпадения. Тогда лучше вводить первые 6 и последние 4 цифры, в таком формате: 123456-7890.
  • Номер кошелька — для платежей из кошелька ЮMoney.
  • Идентификатор платежа в ЮKassa.
  • Номер счёта, который вы выставили покупателю из личного кабинета ЮKassa. См. Счета клиентам.
Есть ограничение: в запросе должно быть минимум 3 символа, иначе поиск не сработает.
Фильтры
Их можно использовать вместе с запросом в поисковой строке — или без него.
  • Календарь — в нём можно задать период или конкретную дату.
  • Способ оплаты — можно выбрать один, несколько или все.
  • Статус платежа — тоже один, несколько или все.
  • Сумма платежа — можно указать минимальную и максимальную (поля «от» и «до»).
Платежа нет в истории
  • Проверьте параметры для поиска — возможно, где-то ошибка.
  • Попробуйте увеличить период в календаре.
Если платёж всё равно не найти, но вы уверены, что он прошёл, напишите в поддержку — будем разбираться.
Выгрузка платежей в файл
Если вам нужно просмотреть больше платежей или иначе их отсортировать, можно выгрузить данные в файл в формате CSV (открывается в Excel и других редакторах для просмотра таблиц).
Для этого укажите нужные параметры в фильтрах в истории платежей: например, можно выгрузить все успешные платежи с банковской карты за три месяца. Потом нажмите Экспорт.
Скачивание файла с выгрузкой начнётся автоматически, когда он будет готов.
Поля в файле с выгрузкой:
ПолеОписание
avisoReceivedDatetimeДата получения уведомления об успешном платеже (если её нет — заказ не был оплачен).
customerNumberИдентификатор пользователя на стороне магазина (если есть).
orderSumCurrencyКод валюты (например, 643 — российский рубль).
paymentTypeКод способа оплаты. Расшифровка кодов
itemNameНазвание товара.
accountIdНомер кошелька пользователя (при оплате из кошелька в ЮMoney).
invoiceIdНомер транзакции в нашем платёжном сервисе.
orderSumСумма платежа.
shopSumСумма, которую получит магазин (сумма платежа минус комиссия платежного сервиса).
Отложенные платежи (предавторизация)
Когда у вас в магазине включена предавторизация, платежи с банковских карт и электронных кошельков проходят в два этапа:
  1. Клиент оформляет заказ на сайте, на его счёте блокируется нужная сумма.
  2. В личном кабинете ЮKassa появляется платёж со статусом Ожидает подтверждения. Этот платёж магазин может подтвердить (деньги у клиента спишутся) или отменить (деньги вернутся клиенту).
Принимать отложенные платежи можно только при подключении по протоколу API. Как это настроить — почитайте в документации.
Если ваш магазин работает на основе CMS, нужно включить отложенные платежи в настройках модуля ЮKassa. Как это сделать — смотрите в инструкции к модулю для вашей CMS.
Как подтверждать и отменять платежи
  1. В личном кабинете ЮKassa перейдите в Операции — Платежи. В списке История платежей найдите платёж со статусом Ожидает подтверждения.
  2. Кликните на строку с нужным платежом и выберите действие — Отменить платёж или Подтвердить.
Статус платежа должен поменяться на Успешный платёж или Отмена. Чтобы проверить статус — перезагрузите страницу через несколько минут.
При отмене платежа понадобится ввести код из смс — он придёт на номер телефона, который привязан к личному кабинету. В течение часа после этого можно отменять платежи без кода.
Для подтверждения платежей вводить код из смс не нужно.
Платежи банковскими картами ожидают подтверждения 7 дней, остальными способами — 6 часов. После этого платёж отменится автоматически и деньги вернутся покупателю. Для каждого платежа справа от кнопки Подтвердить указаны дата и время, когда платёж отменится.