Отчёт по платежам ЮKassa для клиента

Отчёт по платежам ЮKassa для бизнеса и агентства

Через ЮKassa интернет-магазины, онлайн-школы и сервисы принимают оплату за товары, курсы, записи и подписки, и именно её данные отвечают на главный вопрос владельца: сколько реально заплатили покупатели. Обычно эти цифры живут в личном кабинете кассы, а маркетинговый отчёт собирается из рекламных кабинетов и Метрики. Reportkey соединяет обе половины: забирает платежи и возвраты через API ЮKassa и кладёт их в тот же документ, где лежат расходы на рекламу.

Отчёт уходит по расписанию ссылкой или PDF. Клиенту не нужен доступ к кабинету кассы, а специалисту не нужно каждую неделю сохранять реестр операций в таблицу.

Аналитика платежей ЮKassa: какие статусы считаются деньгами

У платежа в ЮKassa четыре состояния. Новый платёж находится в статусе pending, пока покупатель не завершил оплату. При двухстадийной схеме деньги сначала замораживаются на карте — это статус waiting_for_capture, — и магазин сам решает, списывать их или отпускать. Деньги считаются полученными только в статусе succeeded, а canceled означает, что оплата не состоялась или была отменена.

В блок поступлений Reportkey берёт только успешные платежи и датирует их моментом подтверждения (captured_at), а не моментом создания. Для магазинов с двухстадийной оплатой это важно: заказ, оформленный в пятницу и подтверждённый в понедельник, попадёт в неделю, когда деньги действительно стали доступны.

Сумма к зачислению и комиссия ЮKassa

Самый частый спор при сверке — почему в отчёте одна сумма, а на счёте другая. Объект платежа содержит поле amount, то есть оплату покупателя, и поле income_amount — сумму за вычетом комиссии кассы. Reportkey показывает обе:

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

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

Выгрузка возвратов ЮKassa и чистые поступления

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

Способы оплаты: карта, СБП, ЮMoney

Поле payment_method.type раскладывает оборот по способам оплаты: банковская карта, СБП, кошелёк ЮMoney, СберПей, T-Pay и другие подключённые методы. Таблица показывает число платежей, сумму и долю каждого способа. Для владельца это повод проверить, не пора ли поднять СБП выше в форме оплаты, а для агентства — аргумент в разговоре о том, почему мобильный трафик стал платить иначе.

Незавершённые оплаты и причины отмены

Отменённый платёж в ЮKassa содержит причину в поле cancellation_details.reason: отказ банка-эмитента, недостаточно средств, истёкшее время ожидания, отмена магазином. Блок незавершённых оплат считает долю отмен от созданных платежей и группирует их по причинам и способам оплаты. Когда доля отмен по одному методу резко растёт, это сигнал проверить форму оплаты раньше, чем клиент заметит падение выручки.

Что важно знать о данных API ЮKassa

• Это платежи покупателей вашего клиента, а не оплата сервисов самого Reportkey.
• Платёж — денежный результат, а не конверсия рекламы. Канал трафика к нему не привязан, пока сайт не передаёт номер заказа или метки в поле metadata.
• Тестовые платежи с признаком test отбрасываются при сборке.
• Список операций доступен за последние три года; более ранние платежи через API не возвращаются.
• API отдаёт до сотни объектов на страницу, поэтому большой месяц загружается несколькими последовательными запросами — на результат это не влияет.

ЮKassa рядом с рекламой и аналитикой сайта

Деньги лучше всего читаются рядом с тем, что их привело. В том же отчёте можно показать расходы и кампании Яндекс Директа, объявления VK Рекламы и визиты и цели сайта в Яндекс Метрике. Если нужна связь платежа с каналом, её даёт сквозная аналитика Roistat. Для проектов, которые принимают оплату через второго провайдера, добавьте платежи и отказы CloudPayments.

Брендирование, отправка по расписанию и AI-выводы по итогам периода доступны не на всех тарифах. Пример готового документа — в демо-отчёте для in-house команды, остальные магазины и кассы собраны в разделе интеграций для интернет-магазинов и платежей, а условия пробного периода — на странице тарифов.