Missing Metadata в App Store Connect: как исправить

Missing Metadata в App Store Connect означает, что у твоей подписки или встроенной покупки не хватает хотя бы одного обязательного поля. Проверь по порядку язык, цену, срок, страны, скриншот для ревью и договор для платных приложений. Пока продукт в этом статусе, ты не можешь отправить его на ревью, а приложение не может его загрузить. К тому же первая подписка должна уходить вместе с версией приложения.

Я получил этот статус в июле 2026 года на TradaZen, моём симуляторе трейдинга. У новой недельной подписки были срок, цена, группа и два языка. И всё равно она висела в Missing Metadata. Единственное, чего не хватало, это скриншота для ревью. Ниже: причины, которые надо проверить, состояния продукта и что разблокирует каждое из них, а потом связь с RevenueCat.

Что значит Missing Metadata?

До этого года справка Apple описывала статус так: продукт создан, но ты ещё не загрузил скриншот или не заполнил его метаданные. Статус никогда не говорит, какого именно поля не хватает. В этом вся проблема: искать придётся самому.

Внимание, в июле 2026 года название сменилось. В заметках к релизу App Store Connect 15 июля объявлен новый способ отправки: каждая встроенная покупка отправляется со своей страницы через Add for Review. На странице статусов «Missing Metadata» больше нет. Список начинается с «Prepare for Submission» с пояснением: если у встроенной покупки не хватает обязательных метаданных, заполни их, прежде чем добавлять её в отправку. Документация RevenueCat это подтверждает: до ревью новый продукт показывается как «Prepare for Submission», даже если метаданных не хватает.

А вот API App Store Connect по-прежнему возвращает MISSING_METADATA, а затем READY_TO_SUBMIT. Поэтому инструменты, которые на него опираются, всё ещё показывают эти слова. Как бы статус ни назывался, диагноз один: какое-то обязательное поле пустое.

Причины, которые надо проверить, по порядку

Я проверяю их в таком порядке, от страницы продукта до аккаунта.

Причина	Где исправить
Пустое название или описание	Страница продукта
У группы нет отображаемого имени	Страница группы
Нет цены или срока	Страница продукта
Не выбрана ни одна страна	Availability
Нет скриншота для ревью	Review Information
Платный договор не активен	Business
Первая подписка отправлена одна	Отправка

1. Язык продукта. Согласно справке по информации о встроенной покупке, отображаемое название и описание обязательны хотя бы на одном языке. Название от 2 до 30 символов, описание не больше 45. Продукт без языка отправить нельзя.

2. Язык группы. У группы подписок тоже есть отображаемое имя, его видят подписчики, когда управляют подписками на iPhone. Оно задаётся на странице группы, в разделе Display Name and Description, как объясняет страница Apple о подписках. Поле не выглядит обязательным. Но один разработчик рассказывает на форумах Apple, что все подписки его группы были заблокированы, пока оно оставалось пустым. Статус показывается на подписке, а не на группе, отсюда и путаница.

3. Цена и срок. Подписке нужен срок, от недели до года, и цена. Техническая заметка TN3186 начинает с этого, когда продукт не загружается: проверить идентификатор, цену и языки. Запомни ещё, что после отправки на ревью срок изменить уже нельзя.

4. Доступность. Выбери хотя бы одну страну или регион в Availability. Apple уточняет, что без доступности статус «Approved» появиться не может.

5. Скриншот для ревью. Это мой случай с TradaZen и частая причина на форумах. Скриншот «App Review Screenshot» показывает покупку так, как она выглядит в приложении, обычно это твой пейвол. Он нужен только ревьюеру и никогда не показывается в App Store. Форматы те же, что у твоих скриншотов App Store. После загрузки его можно заменить, но не удалить.

Не путай его с промо-изображением 1024 x 1024 пикселя. Оно нужно, только если ты продвигаешь покупку на странице приложения или создаёшь win-back оффер, и у него свои правила. Я узнал это через отказ из-за промо-изображения подписки.

6. Договор для платных приложений. Чтобы предлагать встроенные покупки, владелец аккаунта должен подписать Paid Apps Agreement в Business, а затем указать банковские и налоговые данные. Это не поле продукта, но от него зависит всё. Apple пишет, что ты не можешь создать новую встроенную покупку, пока не принял последнюю версию договора. На странице о подготовке покупок к ревью добавлено, что платные покупки не работают на ревью, пока договор не активен. В Business договор, банковский счёт и налоговые формы должны быть активны. Эти шаги подробно описаны в гайде про аккаунт разработчика Apple.

7. Первая подписка отправлена одна. Это не недостающие метаданные. Но это самая частая причина, по которой полностью заполненный продукт так и не уходит на ревью. Подробнее ниже.

Состояния продукта и что разблокирует каждое

Вот чек-лист, который я держу перед глазами. В первой колонке состояние, которое возвращает API, во второй название из справки Apple с июля 2026 года.

Состояние (API)	Текущее название	Что разблокирует
MISSING_METADATA	Prepare for Submission	Заполнить поля
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Нет аналога	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Ждать Apple
IN_REVIEW	In Review	Ждать Apple
APPROVED	Approved	Страны и одобренное приложение
REJECTED	Rejected	Исправить, Update Review

Подробнее:

• Из Missing Metadata в Ready to Submit. Заполни поля из причин 1-5, сохрани, перезагрузи страницу. В июле у меня экран показывал «Missing Metadata», а следующее состояние называлось «Ready to Submit».
• Из Ready to Submit в Ready for Review. На странице подписки нажми Add for Review и добавь её в существующую или новую отправку. Процедура отправки встроенной покупки попросит выбрать платформу, версию приложения и, если нужно, группу. С этого момента можно менять только референсное название, цену и доступность.
• Из Ready for Review в Waiting for Review. Проверь, что версия приложения и группа в одной отправке, затем нажми Submit for Review.
• Из Waiting for Review в Approved. Делать ничего не нужно, только держи пейвол рабочим. Если покупка перешла в «Accepted», а не в «Approved», значит, другой элемент той же отправки отклонён: Apple ничего не одобряет, пока не принято всё.
• Rejected. Причина появляется в сообщениях отправки. Исправь элемент, нажми Update Review и отправь заново.

Первая подписка уходит вместе с версией приложения

Правило есть в справке Apple: первая подписка, как и первая покупка каждого типа, должна отправляться вместе с новой версией приложения. Новая группа уходит хотя бы с одной своей подпиской. Когда этот первый элемент одобрен, следующие того же типа можно отправлять без новой версии, если у приложения есть одобренная версия.

Именно так было с TradaZen. Июльская версия ушла с годовой и месячной подписками. Недельная, всё ещё в Missing Metadata, в отправку не попала. После одобрения приложения её можно было отправить отдельно, без нового билда.

Если отправишь приложение без подписки, для её одобрения понадобится новая версия. Гайд про сроки проверки в App Store показывает, сколько дней стоит такой лишний цикл.

Связь с RevenueCat: пустой оффер

RevenueCat сам ничего не продаёт. SDK читает идентификаторы твоих продуктов с его серверов, а потом запрашивает продукты у App Store прямо с iPhone. Если App Store их не возвращает, оффер приходит пустым, и пейволу нечего показать. В логах SDK тогда появляется: «There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.»

По словам RevenueCat, продукт с заполненными метаданными загружается в sandbox ещё до ревью. Незаполненный нет. Другие варианты, которые называют RevenueCat и Apple:

• договор для платных приложений и банк, распространение которых может занять до 24 часов, по данным RevenueCat;
• изменение продукта, которое может доходить до sandbox до часа, по данным Apple;
• разные идентификаторы продукта в App Store Connect, RevenueCat и твоём коде.

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

Пейвол без оффера никогда не должен быть тупиком, ни для пользователя, ни для ревьюера, который должен иметь возможность купить. Полная настройка в моём гайде RevenueCat для подписки на iOS, а ловушки отображения в статье про ошибки пейвола. Когда продукт готов, проверь ещё, что пейвол соответствует guideline 3.1.2.

Подключить подписку и не потратить на это неделю

iOS & Android Kit построен на стартовом коде моих приложений: онбординг, пейвол и подписки уже написаны, а его третий шаг, «подключить деньги», проведёт тебя через настройку. Вся цепочка, от продуктов в App Store Connect до проверки покупки, описана на странице встроенная подписка на iOS.

Если готовишь первый релиз, пройди бесплатную диагностику: она расставит шаги по порядку и пришлёт мой чек-лист против отказов Apple. Если подписка всё равно застряла, забронируй со мной час: откроем твой App Store Connect вместе и найдём пустое поле.

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

Почему подписка висит в Missing Metadata, хотя всё заполнено?

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

Нужен ли скриншот для подписки?

Да, скриншот для ревью, App Review Screenshot. Он показывает покупку в приложении, обычно пейвол, и нужен только ревьюеру. В App Store он не показывается. Не путай его с промо-изображением 1024 x 1024 пикселя, которое нужно только для продвижения покупки или win-back оффера.

Можно ли отправить подписку без новой версии приложения?

Первую нельзя. Первая подписка и её группа уходят с новой версией приложения. Когда первая подписка одобрена, следующие можно отправлять отдельно, если у приложения есть одобренная версия.

Что значит Prepare for Submission для встроенной покупки?

Это название из справки Apple с июля 2026 года для продукта, ещё не добавленного в отправку. Оно показывается, даже если метаданных не хватает. API App Store Connect по-прежнему различает эти два случая: MISSING_METADATA и READY_TO_SUBMIT.

Почему RevenueCat возвращает пустой оффер?

Потому что App Store не вернул iPhone ни одного продукта. Самые частые причины: неполные метаданные, неактивный договор для платных приложений, разные идентификаторы продукта или недавнее изменение, которое ещё не распространилось. Пейвол должен обрабатывать этот случай, не блокируя пользователя.