Missing Metadata no App Store Connect: liberar assinatura

Missing Metadata quer dizer que falta pelo menos uma informação obrigatória na sua assinatura ou na sua compra no app. Confira, nesta ordem, o idioma, o preço, a duração, os países, a captura de revisão e o contrato de apps pagos. Enquanto o produto estiver nesse status, você não consegue mandá-lo para revisão, e o seu app não consegue carregá-lo. Além disso, a primeira assinatura precisa ser enviada junto com uma versão do app.

Tive esse status em julho de 2026 no TradaZen, meu simulador de trading. A nova assinatura semanal tinha duração, preço, grupo e dois idiomas. Mesmo assim, continuava em Missing Metadata. A única peça que faltava era a captura de revisão. Aqui vão as causas para verificar, os status de um produto com o que destrava cada um e, depois, a relação com o RevenueCat.

O que significa Missing Metadata?

Até este ano, a ajuda da Apple definia esse status assim: o produto foi criado, mas você ainda não enviou uma captura de tela ou não terminou os metadados dele. O status nunca diz qual campo está faltando. Esse é o problema: você tem que procurar.

Atenção, o rótulo mudou em julho de 2026. As notas de versão do App Store Connect anunciam, em 15 de julho, um novo modo de envio: cada compra no app é enviada pela própria página, com Add for Review. A página de status não lista mais "Missing Metadata". Ela começa por "Prepare for Submission" e explica: se a sua compra no app não tiver os metadados obrigatórios, complete-os antes de adicioná-la a um envio. A documentação do RevenueCat confirma: antes da revisão, um produto novo aparece como "Prepare for Submission", mesmo que faltem metadados.

Já a API do App Store Connect continua retornando MISSING_METADATA e depois READY_TO_SUBMIT. As ferramentas que usam essa API ainda mostram esses termos. Seja qual for o rótulo, o diagnóstico é o mesmo: tem um campo obrigatório vazio.

As causas para verificar, em ordem

Eu verifico nesta ordem, da página do produto até a conta.

Causa	Onde corrigir
Nome ou descrição vazios	Página do produto
Grupo sem nome de exibição	Página do grupo
Preço ou duração faltando	Página do produto
Nenhum país disponível	Availability
Captura de revisão ausente	Review Information
Contrato pago inativo	Business
Primeira assinatura sozinha	Envio

1. O idioma do produto. Segundo a página de informações de uma compra no app, o nome de exibição e a descrição são obrigatórios em pelo menos um idioma. O nome tem de 2 a 30 caracteres, e a descrição no máximo 45. Um produto sem idioma não pode ser enviado.

2. O idioma do grupo. O grupo de assinaturas também tem um nome de exibição, que seus assinantes veem quando gerenciam as assinaturas no iPhone. Ele é adicionado na página do grupo, na seção Display Name and Description, como explica a página da Apple sobre assinaturas. O campo não parece obrigatório. Mas um desenvolvedor conta nos fóruns da Apple que todas as assinaturas do grupo dele ficaram travadas enquanto ele estava vazio. O status aparece na assinatura, não no grupo, e daí vem a confusão.

3. O preço e a duração. Uma assinatura exige uma duração, de uma semana a um ano, e um preço. A nota técnica TN3186 começa por aqui quando um produto não carrega: verificar o identificador, o preço e os idiomas. Lembre também que a duração não pode mais ser alterada depois do envio para revisão.

4. A disponibilidade. Escolha pelo menos um país ou região em Availability. A Apple avisa que, sem disponibilidade, o status "Approved" não pode aparecer.

5. A captura de revisão. Foi o meu caso no TradaZen, e é uma causa que aparece muito nos fóruns. A captura "App Review Screenshot" mostra a compra como ela aparece no app, normalmente o seu paywall. Ela serve só para o revisor e nunca aparece na App Store. Ela segue os formatos das suas capturas da App Store. Depois de enviada, você pode substituí-la, mas não apagá-la.

Não confunda com a imagem promocional de 1024 x 1024 pixels. Essa só serve se você destacar a compra na sua página ou criar uma oferta de recuperação, e tem regras próprias. Aprendi isso com uma rejeição por causa da imagem promocional de uma assinatura.

6. O contrato de apps pagos. Para oferecer compras no app, o titular da conta precisa assinar o Paid Apps Agreement em Business e depois informar os dados bancários e fiscais. Não é um campo do produto, mas tudo depende dele. A Apple escreve que você não pode criar uma nova compra no app enquanto não aceitar a versão mais recente do contrato. A página dela sobre preparar as compras para a revisão acrescenta que as compras pagas não funcionam na revisão enquanto esse contrato não estiver ativo. Em Business, o contrato, a conta bancária e os formulários fiscais precisam estar todos ativos. Essas etapas estão detalhadas no guia da conta de desenvolvedor Apple.

7. A primeira assinatura enviada sozinha. Não é um metadado faltando. Mas é o motivo mais comum para um produto completo nunca ir para revisão. Explico em detalhes mais abaixo.

Os status de um produto e o que destrava cada um

Este é o checklist que deixo sempre à vista. A primeira coluna mostra o status retornado pela API, a segunda o rótulo da ajuda da Apple desde julho de 2026.

Status (API)	Rótulo atual	O que destrava
MISSING_METADATA	Prepare for Submission	Preencher os campos
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Sem equivalente	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Esperar a Apple
IN_REVIEW	In Review	Esperar a Apple
APPROVED	Approved	Países e app aprovado
REJECTED	Rejected	Corrigir, Update Review

Em detalhes:

• De Missing Metadata para Ready to Submit. Preencha os campos das causas 1 a 5, salve e recarregue a página. A tela que eu tinha em julho mostrava Missing Metadata, e o status seguinte se chamava Ready to Submit.
• De Ready to Submit para Ready for Review. Na página da assinatura, clique em Add for Review e adicione-a a um envio existente ou a um novo. O procedimento de envio de uma compra no app pede que você escolha a plataforma, a versão do app e, se precisar, o grupo. A partir daí, só o nome de referência, o preço e a disponibilidade continuam editáveis.
• De Ready for Review para Waiting for Review. Confira se a versão do app e o grupo estão no mesmo envio e clique em Submit for Review.
• De Waiting for Review para Approved. Não tem nada a fazer, só manter o paywall funcionando. Se a compra passar para "Accepted" e não para "Approved", outro item do mesmo envio foi rejeitado: a Apple não aprova nada enquanto tudo não for aceito.
• Rejected. O motivo aparece nas mensagens do envio. Corrija o item, clique em Update Review e reenvie.

A primeira assinatura vai junto com uma versão do app

A regra está na ajuda da Apple: a primeira assinatura, assim como a primeira compra de cada tipo, precisa ser enviada com uma nova versão do app. Um grupo novo vai com pelo menos uma das assinaturas dele. Depois que esse primeiro item for aprovado, você pode enviar os próximos do mesmo tipo sem uma nova versão, desde que o app tenha uma versão aprovada.

Foi o que aconteceu no TradaZen. A versão de julho foi com a anual e a mensal. A semanal, ainda em Missing Metadata, ficou fora do envio. Depois que o app foi aprovado, ela pôde ir sozinha, sem build novo.

Se você enviar o app sem a assinatura, vai precisar de uma nova versão para aprová-la. O guia sobre o prazo de aprovação da App Store mostra quantos dias esse ciclo extra custa.

A relação com o RevenueCat: a oferta vazia

O RevenueCat não vende nada sozinho. O SDK lê os identificadores dos seus produtos nos servidores dele e depois pede os produtos à App Store, a partir do iPhone. Se a App Store não os retornar, a oferta chega vazia e o seu paywall não tem nada para mostrar. Os logs do SDK então exibem: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

Segundo o RevenueCat, um produto com metadados completos carrega no sandbox antes mesmo da revisão. Um produto incompleto, não. As outras pistas que o RevenueCat e a Apple dão:

• o contrato de apps pagos e os dados bancários, que podem levar até 24 horas para se propagar, segundo o RevenueCat;
• uma alteração no produto, que pode levar até uma hora para chegar ao sandbox, segundo a Apple;
• um identificador de produto diferente entre o App Store Connect, o RevenueCat e o seu código.

No TradaZen, o código esconde o card de uma assinatura cujo produto não foi retornado, sem quebrar o paywall. Em outubro de 2026, vi um paywall sem oferta por outro motivo: a oferta lida do cache do SDK estava vazia. Desde então, se a oferta vier vazia, o código do app pede os produtos direto ao StoreKit e oferece tentar de novo se a loja não responder.

Um paywall sem oferta nunca pode ser um beco sem saída, nem para o usuário, nem para o revisor, que precisa conseguir comprar. A montagem completa está no meu guia RevenueCat para uma assinatura iOS, e as armadilhas de exibição estão em os erros de paywall. Com o produto pronto, confira também se o seu paywall respeita a guideline 3.1.2.

Configurar sua assinatura sem perder a semana inteira

O iOS & Android Kit parte do código inicial dos meus apps: onboarding, paywall e assinaturas já estão programados, e a terceira etapa, "conectar o dinheiro", te guia na configuração. A cadeia inteira, dos produtos no App Store Connect até a verificação da compra, está descrita na página assinatura in-app iOS.

Se você está preparando seu primeiro lançamento, faça seu diagnóstico gratuito: ele coloca as etapas em ordem e te envia meu checklist antirrejeição da Apple. Se a sua assinatura continuar travada mesmo assim, reserve uma hora comigo: a gente abre seu App Store Connect juntos e procura o campo vazio.

Perguntas frequentes

Por que minha assinatura continua em Missing Metadata se está tudo preenchido?

Confira primeiro a captura de revisão e depois o nome de exibição do grupo de assinaturas, que não parece obrigatório. Em seguida, verifique o preço, a duração, pelo menos um país e o contrato de apps pagos em Business. Depois de cada correção, salve e recarregue a página antes de tirar conclusões.

Precisa de captura de tela para uma assinatura?

Sim, a captura de revisão, chamada App Review Screenshot. Ela mostra a compra no app, normalmente o paywall, e serve só para o revisor. Ela não aparece na App Store. Não confunda com a imagem promocional de 1024 x 1024 pixels, útil só para destacar a compra ou para uma oferta de recuperação.

Dá para enviar uma assinatura sem uma nova versão do app?

A primeira, não. A primeira assinatura e o grupo dela vão com uma nova versão do app. Depois que essa primeira assinatura for aprovada, as próximas podem ir sozinhas, desde que o app tenha uma versão aprovada.

O que significa Prepare for Submission para uma compra no app?

É o rótulo da ajuda da Apple, desde julho de 2026, para um produto que ainda não foi adicionado a um envio. Ele aparece mesmo que faltem metadados. A API do App Store Connect ainda distingue os dois casos, com MISSING_METADATA e READY_TO_SUBMIT.

Por que o RevenueCat retorna uma oferta vazia?

Porque a App Store não retornou nenhum produto para o iPhone. As causas mais comuns: metadados incompletos, contrato de apps pagos inativo, identificador de produto diferente ou uma alteração recente que ainda não se propagou. O seu paywall precisa lidar com esse caso sem travar o usuário.