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

• vender qualquer quantia de moedas virtuais
• vender pacotes de moedas virtuais

Venda de qualquer quantia de moedas virtuais

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

• 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

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

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

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

• 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

"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"
      }
]

"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

1. Cadastre-se na Conta de Distribuidor Xsolla.
2. Abra seu projeto.

3. Configure módulos para a In-Game Store ou Buy Button.

Configure a moeda virtual

• 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