Use o modelo F2P

Visão geral

Esse caso de uso e as ferramentas pré-prontas da Xsolla possibilitam a monetização free-to-play (F2P) através da sua própria loja virtual. Nesta loja, você pode vender itens virtuais, moedas virtuais e conjuntos em um site externo — independentemente se seu jogo foi feito para PC, consoles, ou se é multiplataforma.

Recursos principais:

  • A interface de pagamento flexível e segura da Xsolla suporta mais de 1.000 métodos de pagamento mundialmente.
  • A interface da loja é fácil de se personalizar usando o construtor de sites, sem ser preciso desenvolvê-lo do zero.
  • Controle total sobre seu catálogo de itens, precificação e promoções.
  • Uma vasta gama de ferramentas LiveOps, como promoções de descontos, vendas cruzadas e sistemas de recompensa.

Esse guia descreve uma configuração rápida e a publicação de uma loja virtual para seu jogo F2P usando as ferramentas da Xsolla.

Quem pode usar

Esse caso de uso é ideal para você se você:

  • desenvolve ou publica jogos para PC, consoles ou multiplataforma;
  • deseja vender bens e moedas virtuais no jogo através do seu próprio site;
  • quer reduzir taxas de plataforma;
  • deseja controle total sobre o marketing, funil de vendas e dados dos usuários.

Como configurar

  1. Crie um projeto na Conta de Distribuidor.
  2. Crie um catálogo de itens.
  3. Crie um site.
  4. Configure os blocos principais.
  5. Configure a autenticação dos usuários.
  6. Configure webhooks para conceder compras ao usuário.
  7. Teste o site.
  8. Publique o site.

Criar catálogo de itens

Para criar um catálogo, você pode:

Observação
Essas instruções fornecem etapas para a configuração básica de um item virtual. Mais tarde, você poderá adicionar outros itens ao catálogo (moeda virtual, conjuntos, chaves de jogo), criar grupos de itens, configurar campanhas promocionais, preços regionais, etc.

Para adicionar itens virtuais com configurações básicas ao catálogo:

  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Virtual items.
  2. No menu suspenso, selecione Create item.

  1. Defina as configurações básicas do item nos seguintes campos:
    • Image (opcional)
    • SKU (ID único do item)
    • Item name
    • Description (opcional)

  1. Especifique o preço do item:
    1. Defina a opção Price in real currency como On.
    2. No campo Default currency, altere a moeda (opcional) e especifique o preço do item.
    3. Se você alterou a moeda no campo Default currency, selecione a mesma moeda no campo Price in real currency.

Observação
Para garantir que as chamadas de API da obtenção de catálogo estejam funcionando corretamente, certifique-se de que a moeda padrão e a lista de moedas na qual os preços são especificados correspondam a todos os itens.

  1. Altere o status do item para Available.

  1. Clique em Create item.

Crie um site

  1. Abra seu projeto na Conta de Distribuidor.
  2. Na página principal do projeto, selecione Change focus e então Sell virtual goods in-game or online.
  1. Na etapa Optional: Set up a web storefront, selecione Create template.
  1. Na aba Express, adicione um link à plataforma onde seu jogo é disponibilizado — Steam ou Epic Games Store. Isso permite que você rapidamente crie um site personalizado para o seu jogo: a imagem do seu jogo, título, nome do desenvolvedor e esquema de cores são adicionados automaticamente ao criar um site.
  1. Selecione Generate web store.
  2. Selecione Continue to set up.

Configure os blocos principais

Observação
Veja abaixo uma descrição de como personalizar os blocos principais do site. Você também pode adicionar e configurar qualquer outro bloco disponível no construtor de sites. Para informações mais detalhadas, consulte a documentação do Site Builder.
  1. Na página principal do site, no foco Sell virtual goods in-game or online, acesse a etapa Optional: Set up a web storefront e selecione Customize site. Você será redirecionado ao construtor de sites, onde poderá personalizar o site criado.
Observação

Se você fechar a página principal do projeto, acesse a seção Storefronts > Websites e selecione Open Site Builder no painel do site criado. Para encontrá-lo, você pode conferir o horário da criação exibido no painel do site.

  1. Configure o bloco Header onde as informações dos usuários e os elementos de navegação são exibidos:
    • Adicione um logotipo do seu jogo ou estúdio.
    • Se necessário, mude os botões predefinidos.

Exemplo de bloco Header:

  1. Configure o Lead block, onde as informações principais sobre sua loja são exibidas:
    • Adicione um nome para a loja, uma descrição e uma imagem de plano de fundo caso não queira usar os dados enviados automaticamente.
    • Adicione marcadores.
    • Especifique as plataformas onde o jogo está disponível.
    • Edite os botões padrões ou adicione novos botões, se necessário.
  1. Configure o bloco Battle pass que exibe uma oferta em destaque:
    • Atualize o plano de fundo padrão do cartão.
    • Adicione um nome e descrição à oferta.
    • Configure o botão de compra: selecione o item a ser vendido e, se necessário, personalize o estilo do botão.
Observação
Se você não estiver vendendo um passe de batalha, você pode remover esse bloco ou personalizá-lo para outras promoções, tais como ofertas especiais. Esse é um bloco universal que suporta a venda de qualquer tipo de item ou assinatura.

Exemplo do bloco Battle pass:

  1. Configure o bloco Store, onde itens virtuais, conjuntos e pacotes de moedas virtuais disponíveis para compra são exibidos:
    • Se necessário, remova as seções adicionadas automaticamente, ou adicione novas seções.
    • No bloco para a seção relevante, selecione o tipo de item e grupo da lista suspensa para exibi-los na página.
Aviso

Se o tipo de item selecionado e grupo não forem exibidos no construtor, certifique-se de que os grupos de itens necessários e pacotes de moedas virtuais têm o status Enabled, ou seja, eles estão disponíveis para exibição na loja, e que os itens estão inclusos nestes grupos. Para verificar ou editar o status dos itens, acesse Items catalog e abra a seção para o tipo de item necessário.

Exemplo de bloco Store:

  1. Configure o bloco Footer que contém informações legais e configurações de privacidade. Você pode:
    • Escolher um layout: colunas ou fileiras.
    • Adicionar um plano de fundo personalizado.
    • Adicionar links em redes sociais.
    • Adicionar restrições etárias.

Exemplo de bloco Footer:

  1. Acesse a seção Cart settings para configurar recursos adicionais. Defina as opções correspondentes como habilitadas:
    • Show promo code field — permite que os usuários apliquem um código promocional ou cupom na interface do carrinho.
    • Login before shopping cart — abre a janela de login ao prosseguir ao carrinho se o usuário não estiver autenticado.
  2. Se necessário, adicione páginas adicionais à sua loja, como as últimas notícias do jogo. Para fazer isso:
    1. Adicione as páginas necessárias seguindo as instruções.
    2. No bloco, onde quiser adicionar um link à página, como Header:
      1. Adicione um novo botão ou edite o existente.
      2. Na seção de configurações do botão, escolha uma ação de clique — Open page.
      3. Na lista suspensa, selecione a página que deverá ser aberta quando o botão é selecionado.

Configure a autenticação do usuário

A autenticação permite que os usuários comprem itens na loja e vejam ofertas personalizadas no catálogo. Configure a autenticação pelo Xsolla Login para dar aos usuários uma vasta gama de métodos de autenticação: via redes sociais, códigos únicos ou links, ou inserindo um login e senha. Você também pode personalizar o widget Xsolla Login e definir restrições etárias para a autenticação.

Para configurar a autenticação de usuários via Xsolla Login:

  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
  2. Selecione Open Site Builder no painel do site necessário.
  3. No construtor de sites, acesse o bloco Login settings.
  4. Escolha Xsolla Login.
  5. Na lista suspensa, selecione New Login. Como resultado, o projeto Login com a autenticação de usuários via e-mail e senha será criado automaticamente. Para configurar outro método de login, siga as instruções.
Observação

Para o projeto Login criado, o URL da loja será automaticamente especificado como um URL de retorno de chamada. O usuário será redirecionado à loja nos seguintes casos:

  • após uma autenticação bem-sucedida
  • após uma confirmação por e-mail bem-sucedida
  • após uma redefinição de senha
  • caso a autenticação falhe

Ao alterar o domínio da loja, o URL de retorno de chamada nas configurações do projeto Login é alterado automaticamente.

  1. Conecte o armazenamento de dados do usuário. Você poderá ter diferentes recursos de produtos disponíveis dependendo da opção de armazenamento de dados (consulte a seção Comparison of user data storage options).
Observação

Você também pode configurar outros métodos de autenticação de usuários:

  • Via ID de usuário
  • via ID de usuário e link profundo
  • via link profundo
  • via Xsolla Login com ID de usuário vinculado

Consulte as instruções para obter informações mais detalhadas sobre a configuração de cada método.

Conceder compra ao usuário

Implemente a concessão de compras ao usuário no seu aplicativo usando informações sobre os dados de transação e itens comprados recebidos nos webhooks da Xsolla. Se você se cadastrou na Conta de Distribuidor depois de 22 de janeiro de 2025, para obter o funcionamento completo da loja e gestão de pagamentos, implemente o processamento dos seguintes webhooks:

Nome do webhookDescrição
User validation > User validation (user_validation)É enviado em diferentes estágios do processo de pagamento para confirmar se o usuário está registrado no jogo.
Serviços de jogo > Webhooks combinados > Pagamento bem-sucedido do pedido (order_paid)Contém dados de pagamento, dados de transação e informações sobre os itens comprados. Use os dados do webhook para adicionar itens ao usuário.
Game services > Combined webhooks > Order cancellation (order_canceled)Contém dados do pagamento cancelado, dados de transação e informações sobre os itens comprados. Use os dados do webhook para remover os itens comprados.
Observação
Consulte as instruções para obter informações detalhadas sobre a configuração de webhooks e a lista de webhooks necessários para as contas cadastradas na Conta de Distribuidor antes do dia 22 de janeiro de 2025.

Teste o site no modo sandbox

Para testar o funcionamento do site no modo sandbox:

  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
  2. Selecione Open Site Builder no painel do site necessário.
  3. Selecione Preview.
  1. Selecione um item e clique no botão de compra.
  2. Escolha o grupo Card de métodos de pagamento.
  3. Insira os dados do cartão bancário de teste. Insira quaisquer valores nos campos restantes. Você também pode especificar detalhes incorretos (número do cartão, data de validade ou CVV) para gerar um erro.
Observação
No modo sandbox, você pode usar apenas cartões bancários de teste. Os pagamentos com cartões bancários sandbox podem ser feitos nas seguintes moedas: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

Publique o site

  1. Para melhorar o desempenho do seu site:
    1. No bloco SEO Settings, defina os parâmetros que serão usados pelos motores de busca e para a prévia de páginas nas redes sociais: envie um favicon, especifique o título e descrição da loja, adicione uma imagem de prévia.
    2. Configure as traduções do site.
    3. Faça alterações no domínio (opcional). Para fazer isso, acesse a seção Storefronts > Websites e selecione Configure no painel do seu site. Na seção Domain, edite o valor Xsolla domain, ou configure o seu próprio domínio.
  1. Depois de fazer todas as alterações necessárias e sua loja virtual estiver pronta para o lançamento, selecione Publish.
Aviso
Se a publicação do site não estiver disponível, verifique se todas as condições foram atendidas:

Configuração de loja expandida

Você pode usar os seguintes recursos estendidos para a sua loja:

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 19 de Setembro de 2025

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!
Não conseguimos enviar seu feedback
Tente novamente mais tarde ou contate-nos via doc_feedback@xsolla.com.