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

# 詐騙防範快速入門

> 在 PlayFab Economy v2 中為 Microsoft Store、iOS、Google Play 及其他平台啟用收據驗證與詐騙防範的快速入門指南。

<Info>
  Economy v2 現已正式推出。如需支援與意見反應，請前往 [PlayFab 論壇](https://community.playfab.com)。
</Info>

本快速入門可讓您開始在 Microsoft Store ([Windows 10/11](https://learn.microsoft.com/en-us/windows/uwp/publish/)、[XBOX](https://learn.microsoft.com/en-us/gaming/xbox/)、[Android](https://blogs.windows.com/windows-insider/2021/10/20/announcing-android-apps-on-windows-11-preview-for-windows-insiders-in-the-beta-channel/)) 上執行收據驗證。

## 必要條件

[PlayFab Economy v2 快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart)可協助您完成設定，並準備好執行收據驗證。

## Microsoft Store 市集收據驗證

* [GetMicrosoftStoreAccessTokens](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-microsoft-store-access-tokens)
* [RedeemMicrosoftStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-microsoft-store-inventory-items)

若要使用兌換 API，您首先要在所使用的任何市集 (Apple Store、Steam、Google Play 等) 中設定您的產品 ID 和價格。一開始，所有產品都是無實體的，也就是玩家可以購買的數位項目，但在 PlayFab 中沒有任何意義。

為了賦予這些項目意義，我們需要在 PlayFab 目錄中鏡像它們。鏡像會將這些無實體的實體轉換為目錄套件組合。當您在新服務中呼叫 `RedeemMicrosoftStoreInventoryItems` 時，我們會在目錄中尋找相符的套件組合，以授與至實體玩家的虛擬庫存。

每個套件組合都可以藉由新增 AlternateId，連結至一或多個合作夥伴市集產品。AlternateId 是 PlayFab 與任何外部 IAP 市集之間的連結。當您的遊戲為指定的玩家實體呼叫兌換時，我們會將此 ID 傳遞至 IAP 市集進行檢查。一般流程如下：

1. 在 Microsoft Store 中建立 1 個 (或多個) 真實世界優惠
2. 在 PlayFab 中以 IAP 市集呼叫權限填入附加元件，並在 PlayFab 中建立連結至您所建立優惠的對應套件組合
3. 呼叫 `RedeemMicrosoftStoreInventoryItems`

<Note>
  與先前版本的 PlayFab 不同，在新系統中，您只需建立一個套件組合優惠，然後將每個需要參考的市集 SKU 新增至 AlternateId 清單。您不需要為每個 IAP 市集建立新的項目。
</Note>

### 步驟 1 - 設定您的市集整合

您必須在 GameManager 的 Add-ons 區段下設定每個 IAP 市集整合，以允許 PlayFab 代表遊戲呼叫市集。

### 步驟 2 - 建立用於收據驗證的套件組合

您可以在 GameManager 中或藉由呼叫 `CreateDraftItem` 來[建立套件組合](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles)。套件組合至少需要 Title、Description 和 Items。在 GameManager 中，您可以使用 Marketplace Mapping 區段連結市集項目。

如果您使用 API 建置套件組合，則需要在套件組合的 alternateIds 區段下新增您的 IAP 市集對應。市集列舉是特定的且區分大小寫；您必須使用下列其中一個附加元件：

* Apple = "AppleAppStore"
* Google Play = "GooglePlay"
* Nintendo = "NintendoEShop"
* Microsoft = "MicrosoftStore"
* PlayStation = "PlayStationStore"
* Steam = "Steam"

### 步驟 3 - 從您的遊戲呼叫兌換

您的遊戲會使用實體和收據詳細資料呼叫 `RedeemMicrosoftStoreInventoryItems` API，以「兌換」真實世界優惠並填入對應的實體庫存。您需要在呼叫中提供幾項內容，才能讓它正確運作：

* 要求標頭中的必要項目
  * X-EntityToken - 唯一識別 PlayFab 實體的權杖
  * Content-Type - Application/Json
* 要求本文中的必要項目
  * `CollectionsIdKey`

每個 IAP 市集發出這些呼叫的需求都略有不同。例如，Apple 和 GooglePlay 購買需要附加市集收據。

當您的遊戲用戶端啟動時，請先為市集發起 PlayFab 兌換呼叫。兌換呼叫可讓 PlayFab 與任何可能在離線時或遊戲範圍之外發生的購買進行同步。每當發生市集優惠的遊戲內購買時，您的遊戲都應該使用這些呼叫。

兌換可確保在呼叫兌換端點之後，玩家實體的庫存貨幣已填入。

## 第 4 部分：購買項目

### Game Manager

您可以在個別的玩家檢視中確認項目或貨幣是否存在。在 GameManager 中，選取 Players，然後瀏覽至個別的玩家實體。使用 Inventory 索引標籤來檢視及更新該實體玩家擁有的內容。

### API

在您的遊戲中，以已獲得虛擬貨幣的玩家身分登入。

呼叫 `SearchItems` 以使用先前發佈的目錄 itemId。

使用目錄項目的 itemId 和所授與的虛擬貨幣 ID 呼叫 `PurchaseInventoryItems`。

最後，呼叫 `GetInventoryItems` 並檢視該方法的結果。

***

若要深入了解在 Microsoft 平台上營利，請參閱[這裡](https://learn.microsoft.com/en-us/windows/uwp/monetize/)。


## Related topics

- [透過 Steam Marketplace 兌換](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/steam.md)
- [使用 Google 市集兌換](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google.md)
- [Economy v2 真實貨幣價格](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [使用 Microsoft Store 市集兌換](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)
- [市集整合 - Microsoft Store](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft.md)