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.

Entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com se você quiser criar uma moeda virtual e um pacote de moedas virtuais com valor zero no preço.

Em campanhas com desconto, campanhas com códigos promocionais ou cupons, você só pode usar pacotes de moedas virtuais. Qualquer quantidade de moedas virtuais só pode ser usada em campanhas com bônus.

Opções para a venda de moedas

Existem as seguintes opções para vender moedas virtuais:

vender qualquer quantia de moedas virtuais
vender pacotes de 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.

Se a lógica da loja no jogo for implementada em seus servidores, você poderá configurar os webhooks de compra.

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

Copy

Full screen

Small screen


"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 Catalog do grupo de métodos Virtual Items & Currency 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 Catalog do grupo de métodos Virtual Items & Currency.

Para exibir corretamente o número de pacotes de moedas virtuais disponíveis para o usuário, você precisa configurar a autenticação.

Exemplo de resposta:

Copy

Full screen

Small screen


{
  "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

Quando você cria uma interface de catálogo usando o Site Builder, o temporizador é exibido automaticamente. Ao criar um catálogo em sua própria interface, você precisa implementar o temporizador.

O período de exibição da moeda virtual no repositório só pode ser configurado usando métodos de API.

Para definir um limite de tempo para a exibição de uma moeda virtual no repositório via API, passe os seguintes parâmetros na chamada de API Create virtual currency ou Update virtual currency:

periods[0].date_from com a data e hora do início do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm
periods[0].date_until com a data e hora do final do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm. Para não indicar o final do período de exibição de um item, passe null

Você pode configurar vários períodos para exibir uma moeda virtual na loja. Para fazer isso, no método Create virtual currency ou Update virtual currency, passe uma matriz de objetos com as datas de início e término de todos os períodos.

Exemplo:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

Para definir um limite de tempo de exibição de um pacote de moedas virtuais na loja pela Conta de Distribuidor, selecione Time period e especifique o fuso horário, o período inicial e o período final. Para não indicar o fim do período de exibição do pacote, marque a caixa No end date.

Para definir um limite de tempo para exibir um pacote no repositório via API, passe os seguintes parâmetros na chamada de API Create virtual currency package ou Update virtual currency package.

periods[0].date_from com a data e hora do início do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm
periods[0].date_until com a data e hora do final do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm. Para não indicar o final do período de exibição de um item, passe null

Você pode configurar vários períodos para exibir um pacote na loja. Para fazer isso, no método Create virtual currency package ou Update virtual currency package, passe uma matriz de objetos com as datas de início e término de todos os períodos.

Exemplo:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

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:

usando a Conta de Distribuidor
usando chamadas de API

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ção Admin dos pontos de extremidade da API Virtual Items & Currency.

Obrigado pelo seu feedback!

Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Última atualização: 10 de Outubro de 2023

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

Your browser is not supported. Please try a different browser

Artigos populares

Ou escolha as mais frequentes:

Resposta com base nas seguintes fontes:

Nos dê seu feedback (opcional)

Nos dê seu feedback (opcional)

In-Game Store

Moedas virtuais

Como funciona

Opções para a venda de moedas

Venda de qualquer quantia de moedas virtuais

Venda de pacotes de moedas virtuais

Entrega de moeda

Moeda forte

Limitação do número de pacotes de moedas virtuais disponíveis para compra

Limitação do tempo de exibição para pacotes de moedas virtuais e moedas virtuais na loja

Quem pode usar

Como obtê-lo

Pré-requisitos

Configure a moeda virtual

Configuração de moedas virtuais na Conta de Distribuidor

Configuração de moedas virtuais por meio de chamadas de API