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

# Economy v2 가상 화폐 빠른 시작

> Game Manager를 사용하거나 타이틀 엔터티 토큰이 있는 Catalog API를 사용해 첫 번째 PlayFab Economy v2 가상 화폐를 만들고 구성합니다.

# 첫 번째 가상 화폐 설정

<Info>
  Economy v2는 이제 정식 출시(GA)되었습니다. 지원 및 피드백은 [PlayFab 포럼](https://community.playfab.com)을 참조하세요.
</Info>

[PlayFab Services SDK](/services/playfab/sdks/playfab-sdk-intro)를 사용해 PlayFab Economy를 시작하고 첫 번째 가상 화폐를 설정합니다. API를 통해 타이틀과 상호 작용하기 위한 엔터티 토큰을 얻은 후 가상 화폐를 만들고 구성합니다.

## 필수 구성 요소

* [PlayFab 개발자 계정](https://developer.playfab.com)
* PlayFab Beta SDK([Postman 빠른 시작](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections)에서 자세한 정보를 확인할 수 있습니다)

## 타이틀 엔터티 토큰 가져오기

API를 통해 타이틀 구성 데이터를 변경하려면 먼저 타이틀 엔터티 토큰을 얻어야 합니다. 자세한 내용은 [Postman 빠른 시작](/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token)에서 확인할 수 있습니다.

## 새 가상 화폐 만들기

새 가상 화폐를 만들려면 Currency 유형의 Draft Item을 만들어야 합니다.

### Game Manager

1. Game Manager에서 **Economy** 탭으로 이동하여 \*\*Catalog (V2)\*\*를 선택합니다.
2. **Currency**를 선택하고 **New currency**를 선택합니다.
3. **Title**을 편집하고 **Description**을 추가합니다. 예를 들어, `Diamonds`, `Our in-game currency of choice.`
4. **Save and publish**를 선택해 변경 사항을 완료합니다.
5. **Currency** 목록에서 화폐를 확인합니다.

### REST API

[CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item)을 호출합니다. 다음 본문을 사용합니다.

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

***

* `FriendlyId`는 통화 코드이며 1\~3자리 영숫자 값을 포함할 수 있습니다.
* `Title`은 플레이어에게 표시되는 표시 이름입니다.
* `ContentType`은 Economy 아이템의 분류입니다. Game Manager의 ⚙️ > Title Settings > Economy > Catalog (V2) Settings에서 Content Type을 먼저 설정해야 합니다.
* `StartDate`는 화폐가 플레이어에게 표시되는 시점을 나타내는 날짜/시간 문자열입니다(기본값은 생성 시간).

## 문제 해결

* 누락되었거나 만료된 엔터티 토큰
  * `CreateDraftItem`을 호출하려 할 때 `401: Unauthorized` 오류가 발생하면 타이틀 엔터티 토큰을 가져오는 것을 잊었거나 만료되었을 수 있습니다.
* 콘텐츠 유형 `''`이(가) 지원되지 않음
  * `CreateDraftItem`을 호출하려 할 때 위 메시지와 함께 `CatalogBadRequest`가 발생하면 Game Manager의 타이틀 설정 페이지 아래 카탈로그 설정 탭에서 콘텐츠 유형을 먼저 만들어야 합니다.

## 다음 단계

이제 첫 번째 가상 화폐를 설정했으므로 다음을 수행할 수 있습니다.

1. 앱 스토어에서 판매하는 PlayFab 번들에 화폐를 추가합니다.
2. [AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)를 사용해 게임 서버가 플레이어에게 화폐를 보상하도록 합니다.
3. 화폐에 해당하는 카탈로그 아이템에 가격을 할당합니다.
4. [PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)를 사용해 플레이어가 화폐로 카탈로그 아이템을 구매할 수 있도록 허용합니다.


## Related topics

- [빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [아이템(레거시 Economy) 빠른 시작](/ko/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy(레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/quickstart.md)
- [Player Inventory 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [스토어(Economy 레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/stores/quickstart.md)