Pular para o conteúdo principal

Configurar sua primeira moeda virtual

O Economy v2 agora está em Disponibilidade Geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.
Comece a usar o PlayFab Economy usando o SDK de Serviços do PlayFab para configurar sua primeira moeda virtual. Depois de obter um token de entidade para interagir com seu título por meio das APIs, você cria e configura uma moeda virtual.

Pré-requisitos

Obter um token de entidade de título

Para fazer alterações nos dados de configuração do seu título por meio das APIs, primeiro você precisa obter um token de entidade de título. Você pode encontrar mais informações no Início rápido do Postman

Criar uma nova moeda virtual

Para criar uma nova moeda virtual, você precisa criar um Item de Rascunho do tipo Moeda.

Game Manager

  1. Navegue até a guia Economy no Game Manager e selecione Catalog (V2).
  2. Escolha Currency e selecione New currency.
  3. Edite o Title e adicione uma Description - por exemplo, Diamonds, Our in-game currency of choice..
  4. Selecione Save and publish para concluir suas alterações.
  5. Observe sua moeda na lista Currency.

API REST

Chame CreateDraftItem. Use o seguinte corpo:

  • O FriendlyId é o código da moeda, que pode conter de um a três valores alfanuméricos
  • O Title é o nome de exibição mostrado aos jogadores
  • ContentType é uma categorização de itens do Economy. Você deve primeiro definir o Content Type em ⚙️ > Title Settings > Economy > Catalog (V2) Settings.
  • StartDate é uma cadeia de caracteres de data e hora que representa quando a moeda fica visível para os jogadores (o padrão é o momento da criação)

Solução de problemas

  • Token de entidade ausente/expirado
    • Se você estiver tentando chamar CreateDraftItem e receber um erro 401: Unauthorized, talvez tenha esquecido de obter um token de entidade de título, ou ele pode ter expirado
  • O tipo de conteúdo '' não é compatível
    • Se você estiver tentando chamar CreateDraftItem e receber um CatalogBadRequest com a mensagem acima, precisará primeiro criar um tipo de conteúdo na guia de configurações do catálogo, na página de configurações do seu título no Game Manager

Próximas etapas

Agora que você configurou sua primeira moeda virtual, você pode:
  1. Adicionar a moeda aos Pacotes do PlayFab que você vende em lojas de aplicativos.
  2. Fazer com que o servidor do jogo conceda a moeda aos seus jogadores como recompensa com AddInventoryItems.
  3. Atribuir preços aos Itens do Catálogo correspondentes à moeda.
  4. Permitir que os jogadores comprem Itens do Catálogo com a moeda usando PurchaseInventoryItems.
Última modificação em 6 de outubro de 2026