Compras no aplicativo Unity : Como configurar sua loja virtual

Uma loja virtual da Unity é uma vitrine online que permite aos jogadores comprar itens do catálogo de IAP do seu jogo na web, em vez de por meio de uma loja dentro do jogo. Isso direciona as transações para fora do jogo, oferecendo mais flexibilidade e margem de lucro para o seu estúdio. As lojas virtuais da Unity são criadas no painel de controle da Unity Cloud , conectadas a um provedor de pagamentos como Stripe ou Coda Payments, e acessadas de dentro do jogo por meio de um link.

Observação: Este artigo utiliza orientações válidas em agosto de 2026 para o Unity IAP 5.4. Versões posteriores podem incluir novos recursos ou uma interface de usuário atualizada.

Este é o artigo final da série de três partes da Unity sobre o IAP 5.4, juntamente com Atualização do IAP 4 para o IAP 5 e Implementação de provedores de pagamento .

1. Crie a loja virtual

No painel do Unity Cloud , abra Compras no aplicativo na barra lateral esquerda e selecione Ir para a loja virtual e, em seguida, Criar loja virtual . Se você estiver configurando isso pela primeira vez, será recebido por um tour de integração. Clique em Criar loja virtual para começar.

Dois campos são obrigatórios:

• Projeto : Dê um nome ao projeto ao qual a loja pertence. Recomenda-se um projeto de teste específico para a configuração inicial.
• Nome do estúdio : Insira o nome oficial do seu estúdio. Note que esse nome se aplica globalmente a todas as lojas virtuais da sua organização, portanto, mantenha-o consistente em toda a sua marca.

Após a criação, você acessará o painel do Editor da Loja Virtual, que apresenta um Painel Geral para configurar o URL exclusivo da sua loja, um seletor de ambiente de produção e uma Janela de Visualização interativa no lado direito para acompanhar seu progresso em tempo real.

2. Teste o layout com o catálogo de demonstração.

Ative a opção "Somente visualização" / "Catálogo simulado" para exibir itens fictícios na loja, como gemas, passes de batalha e pacotes iniciais. Neste modo, nenhum dado financeiro em tempo real é processado. Clique no URL de pré-visualização para abrir o catálogo simulado em uma nova aba do navegador.

3. Defina o tema da vitrine.

O Unity torna a personalização da sua loja virtual incrivelmente intuitiva através da geração automática de temas, utilizando automaticamente uma imagem carregada. No painel "Personalizar tema" , carregue uma imagem principal ou uma miniatura e selecione "Gerar tema" ; o sistema extrai uma paleta de cores e a aplica em toda a loja.

Para ajustes específicos, use a ferramenta de bate-papo " Aprimorar com IA" acima da janela de visualização. Uma instrução em linguagem simples, como "altere o tipo de fonte para Inter", atualiza o JSON do tema subjacente e aplica a alteração às descrições dos itens, preços e botões.

4. Adicione o catálogo de produção e o provedor de pagamento.

Quando estiver satisfeito com o design, desative o catálogo de demonstração e selecione Gerenciar Catálogo . Altere a opção de ambiente de Desenvolvimento para Produção e, em seguida, escolha Adicionar Listagem de Catálogo .

Cada anúncio requer:

• Metadados do item
• Preço base
• Preços localizados
• Um URL de imagem fornecido por uma CDN

Para hospedar ícones de itens, você pode vincular os URLs das suas imagens a uma Rede de Distribuição de Conteúdo (CDN) , como o Google Cloud Storage, o Cloudflare ou o próprio Cloud Content Delivery da Unity.

No cartão Catálogo e Provedor de Pagamento , selecione um provedor de pagamento principal (o Unity integra-se bem com plataformas como Stripe e Coda Payments) e designe um provedor alternativo para que a finalização da compra seja concluída mesmo se o provedor principal não estiver disponível na região do jogador.

5. Execute uma transação de teste

Selecione "Salvar rascunho" e abra o URL da pré-visualização para desenvolvedores em um navegador.

Selecione "Comprar agora" em um item de teste para abrir o modal de finalização de compra seguro do fornecedor.

Insira um endereço de e-mail, um número de cartão de teste do provedor e um endereço de teste válido e, em seguida, efetue o pagamento.

Para compras repetidas com as mesmas credenciais, insira zeros em todos os campos quando solicitado o código de verificação simulado.

Uma confirmação de compra bem-sucedida significa que os webhooks e o gateway de pagamento estão se comunicando corretamente.

6. Conecte a loja virtual ao seu jogo.

O Unity abre a loja virtual por meio de um link direto autorizado do StoreController vinculado ao seu provedor de pagamento ativo. O link direto (deep link) empacota o token de sessão autenticado do jogador e o repassa para o navegador externo do dispositivo.

C#:

// Abra a página inicial

UnityIAPServices.StoreController(PaymentProvider.Name)

.PaymentProvidersExtendedPurchaseService.RedirectToWebshop();

// Abrir uma página de produto específica

UnityIAPServices.StoreController(PaymentProvider.Name)

.PaymentProvidersExtendedPurchaseService.RedirectToWebshop(catalogListingId: "your-listing-id");

Este método empacota com segurança o token de sessão de usuário autenticado do jogador e o redireciona diretamente do aplicativo do jogo para o navegador externo, a fim de concluir a transação sem problemas. Você pode ler mais sobre isso na documentação .

Para uma visão geral de todas as opções para integrar suas compras no aplicativo, incluindo lojas virtuais, consulte o infográfico a seguir e baixe o PDF em alta resolução aqui .