Moedas virtuais

Como funciona

Moedas virtuais são tipos de dinheiros virtuais usados para comprar bens virtuais. Dependendo de como é usada, a moeda virtual afeta o saldo da economia do jogo ou está relacionada à monetização do aplicativo.

Principais recursos:

  • Vender qualquer quantia de Moeda Virtual ou Pacotes de Moeda Virtual com quantia fixa.
  • Vender Moeda Virtual e Pacotes de Moeda Virtual por Moeda Real ou Virtual.
  • Limitar o número de Pacotes de Moeda Virtual disponíveis para compra.
  • Limitar o tempo de exibição de Moeda Virtual e Pacotes de Moeda Virtual na loja.
  • Pacotes de Moeda Virtual gratuitos.
Aviso
Em campanhas de Desconto e em campanhas com Códigos Promocionais ou cupons, você deve usar Pacotes de Moeda Virtual. Quantias arbitrárias de Moeda Virtual só podem ser usadas em campanhas de Bônus.

As seguintes opções só estão disponíveis para a venda de moedas virtuais:

  • Any amount — permite vender Moeda Virtual na quantia especificada pelo usuário. Para usar essa opção, implemente no cliente um campo de entrada que permita ao usuário informar a quantia desejada no momento da compra.
  • Packages — permite vender Moeda Virtual em quantias predefinidas. O Preço de um Pacote de Moeda é definido separadamente e pode diferir do Preço padrão da mesma quantia dessa moeda.

Exemplo: Um pacote contém 100 moedas de ouro e custa $ 90, enquanto o preço de uma moeda de ouro é $ 1.

Restrições:

  • Você pode adicionar apenas um tipo de Moeda Virtual a um pacote.
  • Um preço em outra Moeda Virtual pode ser configurado apenas via Chamadas de API.
  • Um Pacote de Moeda Virtual pode ser gratuito — sem especificar um preço em moeda real ou virtual. Isso pode ser configurado via Conta de Distribuidor ou via Chamadas de API. Moeda Virtual gratuita que não faz parte de um pacote só pode ser criada via Chamadas de API.
  • Um Pacote de Moeda Virtual pode ser gratuito — sem especificar um preço em moeda real ou virtual. Isso pode ser configurado via sua conta ou via Chamadas de API. Moeda Virtual gratuita que não faz parte de um pacote só pode ser criada via Chamadas de API.
  • Um Pacote de Moeda Virtual pode ser gratuito — sem especificar um preço em moeda real ou virtual. Isso pode ser configurado na conta de jogos móveis ou via Chamadas de API. Moeda Virtual gratuita que não faz parte de um pacote só pode ser criada via Chamadas de API.
  • A quantia de Moeda Virtual em um pacote só pode ser especificada como número inteiro.

Como configurar

Configurar na Conta de Distribuidor

Configurar na sua conta

Observação
Antes de configurar Moeda Virtual ou Pacotes de Moeda Virtual, recomendamos criar grupos para ajudar você a organizar os itens e gerenciar como eles são exibidos na sua loja.

Configurar via API

Para configurar Moedas Virtuais, você pode usar as Chamadas da subseção Admin no grupo Itens virtuais e moeda.

Aviso
As Chamadas da subseção Admin não são destinadas a criar um catálogo da loja no front-end. Não as use em Páginas de Destino, lojas na Web e lógica dentro do jogo.
TarefaChamada de API
Criar Moeda Virtual.Criar Moeda Virtual.
Obter Moeda Virtual.Obter Moeda Virtual.
Obter uma lista de Moedas Virtuais.Obter lista de Moedas Virtuais.
Atualizar Moeda Virtual.Atualizar Moeda Virtual.
Excluir Moeda Virtual.Excluir Moeda Virtual.
Limitar a quantia de Moeda Virtual disponível para compra.Nas Chamadas de API Criar Moeda Virtual ou Atualizar Moeda Virtual, envie os seguintes parâmetros:
  • limits — especifica a quantidade máxima de Moeda Virtual disponível para compra.
  • limits.recurrent_schedule — define com que frequência o limite é reiniciado.
Criar Pacote de Moeda Virtual.Criar Pacote de Moeda Virtual.
Obter Pacote de Moeda Virtual.Obter Pacote de Moeda Virtual.
Obter uma lista de Pacotes de Moeda Virtual.Obter lista de Pacotes de Moeda Virtual.
Atualizar Pacote de Moeda Virtual.Atualizar Pacote de Moeda Virtual.
Excluir Pacote de Moeda Virtual.Excluir Pacote de Moeda Virtual.
Limitar o número de Pacotes de Moeda Virtual disponíveis para compra.Nas Chamadas de API Criar Pacote de Moeda Virtual ou Atualizar Pacote de Moeda Virtual, envie os seguintes parâmetros:
  • limits — especifica a quantidade máxima de Pacotes de Moeda Virtual disponíveis para compra.
  • limits.recurrent_schedule — define com que frequência o limite é reiniciado.
Aviso
O período de exibição de Moeda Virtual na loja pode ser configurado somente via Chamadas de API.

Exibir Moeda Virtual no catálogo

A exibição de Moeda Virtual ou Pacotes de Moeda Virtual depende de como o catálogo é implementado — pelo editor de sites ou via API.

Exibir via editor de sites

Observação
Apenas Pacotes de Moeda Virtual podem ser exibidos no catálogo da loja.

Para exibir um pacote de moedas virtuais:

  1. Criar Pacote de Moeda Virtual.

  2. No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.

  3. Clique no painel do site desejado.

  1. Criar Pacote de Moeda Virtual.

  2. No projeto na sua conta, vá para a seção Storefronts > Websites.

  3. Clique no painel do site desejado.

  1. Criar Pacote de Moeda Virtual.

  2. No projeto na sua conta, vá para a seção Storefronts > Websites.

  3. Clique no painel do site desejado.

  1. Criar Pacote de Moeda Virtual.

  2. No projeto na sua conta, vá para a seção Storefronts > Websites.

  3. Clique no painel do site desejado.

  1. Criar Pacote de Moeda Virtual.

  2. No seu projeto na conta para Jogos de Celular, acesse a seção Web Shop.

  3. Clique no painel do site desejado.

  1. Se o seu site tiver várias páginas, selecione a que você precisa:

    1. Selecione o título da página atual na parte superior do editor.
    2. Selecione a página necessária na lista suspensa.

  2. Na seção do bloco Store, selecione o Pacote de Moeda Virtual que você quer vender no site no campo Item type.

  1. Defina um layout para o cartão do item.

  2. Depois de fazer todas as alterações necessárias e preparar seu site para o lançamento:

    1. No canto superior direito do editor do site, clique em Publish.
    2. Marque as caixas ao lado das páginas que você quer publicar.
    3. Clique em Publish.

Aviso

Se a publicação do site não estiver disponível, certifique-se de que todas as condições sejam atendidas:

  • Não há seções vazias no site (marcadas com um indicador vermelho).
  • O Acordo de Licenciamento com a Xsolla foi assinado.
  • A página principal está publicada ou selecionada para publicação. Você não pode publicar páginas filhas antes da página principal.

Depois que o site for publicado, uma seção com Pacotes de Moeda Virtual ficará disponível. Se nenhum pacote for exibido, verifique se o Status está definido como Available e se nenhum limite de exibição por tempo está ativo.

Obter informações de Moeda Virtual via API

Para recuperar o Catálogo de Moedas Virtuais e Pacotes de Moeda Virtual no lado do cliente, use as Chamadas da subseção Catalog do grupo Itens virtuais e moeda.

TarefaChamada de API
Obter Moeda Virtual por SKU.Passe o parâmetro virtual_currency_sku para a Chamada de API Obter Moeda Virtual por SKU.
Obter uma lista de Moedas Virtuais.Obter lista de Moedas Virtuais.
Obter um Pacote de Moeda Virtual por SKU.Passe o parâmetro virtual_currency_package_sku para a Chamada de API Obter Pacote de Moeda Virtual por SKU.
Obter uma lista de Pacotes de Moeda Virtual.Obter lista de Pacotes de Moeda Virtual.

Conceder Moeda Virtual aos usuários

Dependendo do tipo de item e configurações de integração, a moeda virtual é concedida ao usuário de uma das seguintes maneiras:

  • Se você integrou o PlayFab, Moeda Virtual e Itens são concedidos automaticamente ao inventário PlayFab do usuário.

  • Se você usa um sistema de entrega personalizado, todos os Itens Virtuais e Moeda Virtual são concedidos do seu lado. Recomendamos configurar um Manipulador de Webhook para receber dados do Pedido no seu backend. Os dados necessários estão incluídos no Webhook Successful payment for order.

Consulte a seção Configurar o Rastreamento do Status do Pedido para mais detalhes sobre este e outros métodos de obtenção de dados de compra.

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: 15 de Mai de 2026

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 [email protected].