Moedas virtuais
Como funciona
Moeda virtual é um tipo de dinheiro virtual que é usado para comprar e vender bens virtuais. Dependendo de sua finalidade, uma moeda virtual afeta o equilíbrio da economia do jogo ou está conectada à monetização do aplicativo.
Principais características:
- Venda qualquer quantia de moedas virtuais ou um pacote separado de moedas com um valor fixo.
- Venda moedas fortes.
- Venda moedas virtuais e pacotes de moedas virtuais por dinheiro real ou virtual.
- Limitação do número de pacotes de moedas virtuais disponíveis para compra.
- Limitando o tempo de exibição de pacotes de moedas virtuais e moedas virtuais na loja.
- Itens grátis.
Opções para a venda de moedas
Existem as seguintes opções para vender moedas virtuais:Venda de qualquer quantia de moedas virtuais
Venda a moeda virtual em valores exigidos pelos usuários. Implemente a solicitação para inserir a quantidade necessária de moeda para compra no lado do cliente do aplicativo.Venda de pacotes de moedas virtuais
Venda a moeda virtual em valores predefinidos. Esse recurso permite que você venda moedas do jogo em pacotes, para os quais o preço pode ser menor do que se a moeda fosse comprada com uma quantia personalizada.
Exemplo: para um pacote, você pode definir um preço especial que não seja igual à quantidade de moedas virtuais nele. Por exemplo: 1 moeda virtual = 1 USD. 500 moedas virtuais = 450 USD.
Restrições:
- Você pode adicionar apenas um tipo de moeda virtual a um pacote.
- Você pode criar um pacote de moedas virtuais sem especificar seu preço em moeda real ou virtual. Se esse item for exibido na loja, ele estará disponível para os usuários gratuitamente.
- A quantia de moedas virtuais pode ser especificada apenas como valor inteiro.
Entrega de moeda
Métodos de entrega disponíveis:- Diretamente para o Inventário Xsolla (método padrão). Antes da entrega, o pacote de moedas virtuais é descompactado e a moeda do pacote é concedida ao inventário do jogador.
- Para o PlayFab, se você configurou a integração.
Moeda forte
Moeda forte é uma moeda que está ligada à plataforma de compra e pode ser comprada apenas por dinheiro real.
Restrições:
- Você pode dar à moeda um status de difícil somente durante a primeira configuração.
- Você pode vender pacotes de moeda virtual com moeda virtual dura apenas por dinheiro real.
Para armazenar moeda forte separadamente em plataformas diferentes:
- Defina a opção Hard virtual currency como On.
- Ao chamar os pontos de extremidade da API para o gerenciamento de inventário, passe a cadeia de caracteres com a plataforma de compra para o campo
platform
.
EXEMPLO
- html
"platform": “playstation_network”
Limitação do número de pacotes de moedas virtuais disponíveis para compra
Você pode limitar a compra de pacotes de moeda virtual. Por exemplo, você pode limitar:
- o número de pacotes de moedas virtuais por usuário
- pacotes de moedas virtuais de boas-vindas que só estão disponíveis para compra uma vez
Se o usuário tiver atingido o limite especificado, o pacote de moedas virtuais não será exibido no catálogo.
Você pode exibir o número máximo disponível de pacotes e o número restante de pacotes que está disponível para o usuário.
Para definir um limite de compra ao criar um pacote de moedas virtuais na Conta de Distribuidor, defina a opção Limit number of times one user can buy package como On e especifique o número de vezes que o pacote pode ser comprado.
Você pode usar os métodos da subseção Catálogo do grupo de métodos Itens virtuais & moeda para obter informações sobre pacotes de moedas virtuais.
Na resposta, você receberá as seguintes informações, além de informações sobre o pacote de moedas virtuais:
- o número máximo de pacotes de moedas virtuais que um usuário pode comprar
- o número restante de pacotes de moedas virtuais disponíveis para o usuário comprar
Você pode ler mais sobre como configurar ou atualizar restrições nas instruções Limites para o usuário.
Para usuários não autorizados, o número máximo de pacotes de moedas virtuais que eles podem comprar é sempre exibido. Para exibir o número restante de pacotes de moedas virtuais para o usuário (sujeito ao limite atual), passe os dados de autorização do usuário quando você solicitar o catálogo de pacotes de moedas virtuais usando os métodos da subseção Catálogo do grupo de métodos Itens virtuais & moeda.
Para exibir corretamente o número de pacotes de moedas virtuais disponíveis para o usuário, você precisa configurar a autenticação.
- json
{
"items": [
{
"sku": "vc_package_1",
"name": "VC Name first package",
"groups": [],
"attributes": [],
"type": "bundle",
"description": "VC Short Package Description",
"image_url": "http://vc_package_image.png",
"is_free": false,
"price": {
"amount": "2.0000",
"amount_without_discount": "2.0000",
"currency": "USD"
},
"bundle_type": "virtual_currency_package",
"content": [
{
"description": "Big Rocket - short description",
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"sku": "big_rocket",
"name": "Big Rocket",
"type": "virtual_currency",
"quantity": 100,
"inventory_options": {
"consumable": {
"usages_count": 1
},
"expiration_period": null
}
}
],
"virtual_prices": [],
"limits": {
"per_user": {
"total": 5,
"available": 5
},
"per_item": null
},
"can_be_bought": true
},
{
"sku": "vc_package_3",
"name": "VC Name third package",
"groups": [],
"attributes": [],
"type": "bundle",
"description": "VC Short Package Description",
"image_url": "http://vc_package_image.png",
"is_free": false,
"price": {
"amount": "4.0000",
"amount_without_discount": "4.0000",
"currency": "USD"
},
"bundle_type": "virtual_currency_package",
"content": [
{
"description": "description",
"image_url": "http://image.png",
"sku": "shotgun_raider",
"name": "SHOTGUN FOR TRUE RAIDERS",
"type": "virtual_currency",
"quantity": 200,
"inventory_options": {
"consumable": {
"usages_count": 1
},
"expiration_period": null
}
}
],
"virtual_prices": [],
"limits": {
"per_user": {
"total": 5,
"available": 5
},
"per_item": null
},
"can_be_bought": true
}
]
}
A Xsolla garante que os limites não sejam excedidos e impede que os usuários comprem mais pacotes de moedas virtuais do que o limite definido.
Ao abrir a interface de pagamento e pagar por um pacote, todos os pedidos não pagos com este pacote se tornam inválidos.
Exemplo: o usuário pode abrir o formulário de pagamento de um item com restrição de compra em várias abas do navegador até que o item tenha sido comprado. Isso resulta automaticamente na criação de vários pedidos para o mesmo item. Depois de comprar um item em uma aba, a Xsolla anulará todos os pedidos não pagos com o mesmo pacote.
Limitação do tempo de exibição para pacotes de moedas virtuais e moedas virtuais na loja
Você pode definir o período de exibição de uma moeda virtual e um pacote de moedas virtuais na loja para:- manter a relevância do catálogo em um determinado momento, por exemplo, durante as vendas de fim de ano
- crie uma moeda virtual e pacotes de moedas virtuais com antecedência sem exibi-las no catálogo
- motive os usuários a comprar pacotes de moedas virtuais e moedas virtuais exibindo um temporizador ao lado do item
Quem pode usar
- Para parceiros que desejam configurar a economia do jogo ou a monetização adicionando moedas virtuais ao jogo e vendendo itens virtuais com elas
- Para parceiros que integraram pelo menos um dos seguintes produtos:
- In-Game Store no jogo com o módulo Virtual Items configurado.
- Buy Button com o módulo Game Keys configurado.
Como obtê-lo
Pré-requisitos
- Cadastre-se na Conta de Distribuidor Xsolla.
- Abra seu projeto.
- Configure módulos para a In-Game Store ou Buy Button.
Configure a moeda virtual
Você pode configurar moedas virtuais de uma das seguintes maneiras:Configuração de moedas virtuais na Conta de Distribuidor
Configuração de moedas virtuais por meio de chamadas de API
Use as chamadas de API da subseçãoEncontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.