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:

Observação
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.
Aviso
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:

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.
Observaçã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.

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

Observação

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.

Exemplo de uma resposta com atributos de usuário:
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
    }
  ]
}
Observação

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
Observação
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.

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:

Como obtê-lo

Pré-requisitos

  1. Cadastre-se na Conta de Distribuidor Xsolla.
  2. Abra seu projeto.
  1. 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ção Admin dos pontos de extremidade da API Virtual Items & Currency.
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: 10 de Outubro de 2023

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!