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.
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
Configurar via API
Para configurar Moedas Virtuais, você pode usar as Chamadas da subseção Admin no grupo Itens virtuais e moeda.
| Tarefa | Chamada 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:
|
| 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:
|
Para mais informações sobre limites, veja os seguintes guias:
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
Para exibir um pacote de moedas virtuais:
No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
Clique no painel do site desejado.
No projeto na sua conta, vá para a seção Storefronts > Websites.
Clique no painel do site desejado.
No projeto na sua conta, vá para a seção Storefronts > Websites.
Clique no painel do site desejado.
No projeto na sua conta, vá para a seção Storefronts > Websites.
Clique no painel do site desejado.
No seu projeto na conta para Jogos de Celular, acesse a seção Web Shop.
Clique no painel do site desejado.
Se o seu site tiver várias páginas, selecione a que você precisa:
- Selecione o título da página atual na parte superior do editor.
- Selecione a página necessária na lista suspensa.
Na seção do bloco Store, selecione o Pacote de Moeda Virtual que você quer vender no site no campo Item type.
Depois de fazer todas as alterações necessárias e preparar seu site para o lançamento:
- No canto superior direito do editor do site, clique em Publish.
- Marque as caixas ao lado das páginas que você quer publicar.
- Clique em Publish.
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.
| Tarefa | Chamada 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.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.




