> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido de moeda virtual do Economy v2

> Crie e configure sua primeira moeda virtual do PlayFab Economy v2 usando o Game Manager ou as APIs de Catálogo com um token de entidade de título.

# Configurar sua primeira moeda virtual

<Info>
  O Economy v2 agora está em Disponibilidade Geral. Para obter suporte e enviar comentários, acesse o [Fórum do PlayFab](https://community.playfab.com).
</Info>

Comece a usar o PlayFab Economy usando o [SDK de Serviços do PlayFab](/pt-BR/services/playfab/sdks/playfab-sdk-intro) 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

* Uma [conta de desenvolvedor do PlayFab](https://developer.playfab.com)
* O SDK Beta do PlayFab (você pode encontrar mais informações no [Início rápido do Postman](/pt-BR/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))

## 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](/pt-BR/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token)

## 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](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item). Use o seguinte corpo:

```JSON theme={null}
{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}
```

***

* 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](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items).
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](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items).


## Related topics

- [Início rápido](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Início rápido de itens (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Início rápido do Economy (Legado)](/pt-BR/services/playfab/economy-monetization/economy/quickstart.md)
- [Início rápido do inventário do jogador](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [Início rápido de prevenção contra fraudes](/pt-BR/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)