# 网上商店中的目录和付款

> 了解网上商店如何重用项目的应用内购 (In-App Purchasing) 目录并将购买转发给您现有的付款提供商。

应用商店从 Unity Cloud 项目中读取[应用内购 (IAP)](/iap.md) 目录，并将每次购买路由到您在游戏中使用的相同 [IAP 付款提供](/iap/payment-providers.md)商。玩家在网络上看到的目录与您为移动应用程序维护的目录相同。

## 目录源##catalog-source

当玩家访问您的商店时，Webshop 会从 IAP 请求您的项目的商品目录，并将其渲染到商店的主题布局中。

当玩家加载新会话时，您在[目录](/iap/create-catalog-in-editor.md)中所做的更改会自动流向网上商店。

网上商店按 IAP 返回商品的顺序和分组显示商品。要更改商品顺序或分组，请在 IAP 中更新目录。

## 商品显示字段##product-display-fields

对于每种商品，Webshop 会显示以下面向玩家的字段：

| 字段       | 描述                                                                                                                                    |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 标题和描述    | 商品的显示名称和面向玩家的描述，渲染为商品卡片的标题和正文文本。                                                                                                      |
| "price": | 以玩家货币表示的商品价格，渲染为卡上的主要价格。                                                                                                              |
| 销售价格     | 当商品正在销售时，Webshop 会将销售价格显示为主价格，并在旁边划出原始价格。                                                                                             |
| 标示       | 卡上的可选芯片，例如 **Best value** 或 **+20% bonus**。徽章文本和图标设置在 IAP 目录中，并且网上商店会自动显示它们。任何商品都可以有标示，无论是否在销售中。有关更多信息，请参阅[销售和标示](#sales-and-badges)。 |
| 产品图像     | 商品的可选镜像。没有图像的卡片使用主题的默认占位符。                                                                                                            |

网上商店将商品字段与您的主题（包括颜色、字体和布局）框在一起。它还使用您的品牌来框选商品字段，包括英雄横幅和缩略图。有关主题和品牌的更多信息，请参阅[主题和品牌](./theming-and-branding.md)。有关 Webshop 从每个商品读取的字段的完整列表，请参阅 [Webshop 目录架构参考](./catalog-schema.md)。

在发布之前，请确保您的 IAP 目录至少有一个商品可用于网络销售。如果您的 IAP 目录为空，则商店会渲染时没有商品卡。

### 销售和标示##sales-and-badges

网上商店从 IAP 目录中读取销售定价和标示。您不会在 Webshop Dashboard（Webshop 后台）中进行配置。

* 销售：设置商品的网络价格并在目录中将商品标记为正在销售。网上商店会自动将商品的常规价格显示为删除线值。您只需在目录中设置销售价格并将商品标记为正在销售。
* 标示为目录中的每个列表添加标示文本和可选图标，例如**最佳值**或 **+20% 奖励**。当某个列表有销售时，标示会自动设置为网上商店价格和商品标准价格的折扣百分比，但可以手动覆盖。 徽章与销售分开，因此任何商品都可以有徽章。
* 奖励：当您将商品标记为具有**奖励**推荐时，Webshop 会将列表的 **Subtitle** 字段显示为删除线。使用此属性可显示标题为 `120 Gems` 且副标题为 `100 Gems` 的划线商品，以指示列表中包含奖励数量的宝石。

配置您在 IAP 中定义产品的销售和标示。

## 商品在 Webshop 中的可见性##product-visibility-in-webshops

网上商店仅显示您在 IAP 目录中提供的网上销售商品。要包含或排除网上商店的商品，请更新其在目录中的可见性。此更改将在下次应用商店获取目录时出现。

有关更多信息，请参阅[目录和目录列表](/iap/catalogs-and-catalog-listings.md)。

## 特定于玩家的目录设置##player-specific-catalog-settings

您可以在 IAP 设置中配置货币、区域设置和特定于玩家的商品选择。当网上商店请求商品时，它会将玩家的会话上下文传递给 IAP，包括游戏在深层链接中发送的任何`locale`和`currency`参数。网上商店会渲染目录返回的内容。要更改特定玩家看到的内容，请在 IAP 中更改配置。

## 付款流程##payment-flow

网上商店不会直接处理付款。相反，他们会将每次购买路由到已经为您的项目配置的 [IAP 付款提供](/iap/payment-providers.md)商。这是处理移动应用程序中购买的同一提供商。

授权付款后，网上商店流程完成。收据验证、授权授予和退款使用与游戏内购买相同的 IAP 流程。您无需调节单独的网上商店分类账。

有关购买后面向玩家的退货流程，请参阅[从游戏开店](./deep-links.md#post-purchase-return-to-the-game)。

## 在草案中测试购买##test-purchases-in-a-draft

**开发预览 URL** 将显示在 **Edit** 视图的 **General** 部分中。它会在浏览器中打开环境的草案配置。

> **Warning:**
>
> 开发预览 URL 将打开实时结帐流程。如果您的项目配置了真实目录和付款提供商，完成购买会产生真实费用并授予真实权利。

要在不花费真实资金的情况下测试完整的购买流程，请使用付款提供商文档中的沙盒帐户或测试卡。网上商店没有单独的测试模式。IAP 支付提供商负责管理测试模式。

要在没有真实目录或测试交易的情况下预览主题，请在 **Edit** 视图的 **Catalog & payment provider** 部分中启用 **Mock catalog**。然后，**Preview** 面板会显示一组固定的示例商品。模拟商品仅存在于 Dashboard 预览中。玩家无法购买它们，它们也不会出现在发布的商店中。