区域定价

设置商品目录时，可为虚拟物品和游戏密钥套餐配置面向不同国家/地区用户的价格政策（区域定价）。每个商品或游戏密钥套餐的价格默认以美元设置。您可以同时设置区域限制和区域价格。

运行机制

目录中的价格基于用户所在国家/地区。

通过支付中心进行购买的过程中，商品价格将转换为用户所在国家/地区的货币价格且含税（如适用）。

国家/地区的决定

• 请求商品目录时，用户国家/地区在虚拟物品和货币或游戏密钥方法组的目录子部分下的方法的country参数中传递。
  如未指定国家/地区，将基于用户的IP地址决定。据此再针对用户国家/地区选择商品目录的价格。
• 购买商品时：
  • 如使用客户端方法来获取支付令牌，切记应只从客户端侧使用它们，而不要从服务器侧使用。客户端方法中的国家/地区和货币由用户IP地址决定。从服务器侧使用该方法可能造成错误的货币决定并影响支付中心中的支付方式。
  • 如使用为购买创建支付令牌服务器方法，需在请求正文中传递country对象或在X-User-Ip头中传递用户IP地址。

1. 1. 如在country.value参数中传入了国家/地区且在X-User-Ip头中传入了IP地址，则country.value参数中的国家/地区值优先。

商品目录中的价格显示原则

应对目录中的所有商品使用相同的货币列表来指定价格。

这样做是为了让目录中的所有商品以相同的货币显示。如未对某个国家/地区的某个商品指定价格，则整个目录的价格在该国家/地区以默认货币显示。

如果商品的默认货币不同，则价格以目录中第一个商品的默认价格显示。如某个商品没有该货币下的价格，则响应中对它的价格返回null值。这会导致该商品价格显示不正确，并可能影响目录的整体显示。

示例：

• 1个商品，1种货币，无区域价格
• 1个商品，2种货币，无区域价格
• 1个商品，存在区域价格
• 多个商品，存在区域价格，一种默认货币
• 多个商品，存在区域价格，不同默认货币

该商品的默认货币是USD，且价格是5 USD，没有国家/地区设置。该情况下，所有国家/地区的用户都将看到该价格。

商品设置了两个价格选项：一个USD，一个EUR，但未指定针对国家/地区的特殊价格。该情况下，来自欧元使用国家的用户将看到价格为7 EUR。所有其他国家的用户将看到价格为5 USD，因为该价格是默认货币下的价格。

项目具有以下货币下的价格：

• 默认价格 — 7 USD
• 欧元价格 — 6 EUR
• 区域价格：
  • 德国 — 8 EUR
  • 意大利 — 5 EUR
  • 马来西亚 — 20 MYR
  • 南非 — 90 ZAR

根据用户的国家/地区，价格在目录中将作如下显示：

用户国家/地区	目录价格	注释
美国	7 USD	美国是使用USD的国家。未指定针对美国的特殊价格。
日本	7 USD	未指定日元，因此价格以默认货币显示。
法国	6 EUR	法国是使用EUR的国家。未指定针对法国的特殊价格。
德国	8 EUR	指定了针对德国的区域价格。
意大利	5 EUR	指定了针对意大利的区域价格。
马来西亚	20 MYR	指定了针对马来西亚的区域价格。
南非	90 ZAR	指定了针对南非的区域价格。

项目包含用以下货币指定的价格：

• 所有商品的默认价格用美元(USD)指定
• 在马来西亚，所有商品价格以马来西亚令吉(MYR)指定
• 在南非，除一个商品之外的所有商品价格以南非兰特(ZAR)指定

该情况下，目录对来自马来西亚的用户以MYR显示，但对南非的用户以USD显示。对于来自南非的用户，由于有一个商品没有指定ZAR价格，因此目录以USD显示。

项目具有用以下货币指定的价格：

• 1_test_item的默认价格为美元(USD)
• item 2_test_item的默认价格为欧元(EUR)
• 在南非，1_test_item的价格以南非兰特(ZAR),指定，而对2_test_item未指定区域价格

该情况下，对于来自南非用户，价格应以目录中的首个商品(1_test_item)的默认货币显示。

1_test_item的默认货币 — USD。它与2_test_item的默认货币 — EUR不一致。且后者并没有指定USD下的价格。

因此，对于2_test_item，返回的价格值为null。

适用对象

希望通过设置针对不同国家/地区用户的商店定价政策从而增加购买力较低国家/地区销量的合作伙伴。

如何获取

您可以通过以下方式添加、编辑和删除区域价格：

• 创建/编辑商品时通过发布商帐户进行
• 使用文件导入价格时通过发布商帐户进行
• 使用API方法

创建和编辑商品时通过发布商帐户进行设置

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店。
3. 在虚拟物品窗格中，单击配置。
4. 单击+，然后从下拉列表中选择创建物品。

5. 指定：
   • 图片
   • SKU
   • 该物品所属的一个或多个组
   • 名称
   • 描述
   • 物品属性 — 消耗品、非消耗品或到期性订阅
6. 在价格设置区块，选择付费物品。
7. 将真实货币定价开关切换为开并指定价格。如未设置区域价格，则该物品在所有国家/地区中的价格相同并以美元表示。

8. 设置价格：
   • 如要设置不同货币下的物品价格，请单击+，然后指定货币和价格。
   • 如要针对国家/地区设置特殊价格，请单击添加定价，然后指定国家/地区、货币和数量。您可以根据需要设置多个区域价格。
9. 如要添加以虚拟货币表示的价格，请将虚拟货币定价开关设置为开，然后指定价格。
10. 如要限制指定用户的物品可购数量，请将限制单个用户可购买此物品的次数开关设置为开，然后指定数量。
11. 如要在商店中显示物品，请将在商店中显示物品开关设置为开。
12. 单击创建物品。

在发布商帐户中从文件导入

您可以从文件中导入预创建商品的区域价格。

功能：

• 一次性上传或更新多个商品的区域价格。
• 支持所有类型的商品：
  • 虚拟物品
  • 虚拟货币
  • 虚拟货币套餐
  • 捆绑包
  • 特定平台上的游戏密钥套餐

• 验证上传的数据。如文件结构或数据格式不符合要求，您将在导入过程中看到错误列表。

• SKU — 要为其设置区域价格的商品SKU。
• Country — 用ISO 3166-1 alpha-2格式指定的国家/地区代码。上传CSV文件前请检查艾克索拉支持的国家/地区列表。列中的单元格是选填的。您可以查看在未指定国家/地区的情况下的价格显示示例。
• Currency — ISO 4217格式的货币代码。
• Amount — 商品的价格。小数点用句点表示。

• IsDefault — 是否为默认价格。指定：

  • 1 — 在使用默认价格的行中使用该值。它将显示在所有无区域价格的国家/地区中。
  • 0 — 在所有其他行中使用该值。您也可以将IsDefault列的单元格留空。

1. 默认价格不应为区域价格，请将Country列的单元格留空。
   如文件中有多个商品SKU，则必须为每个SKU设置默认货币下的价格。如未指定，导入文件时将显示错误。

价格文件示例：

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店，然后前往包含任意产品类型的部分。
3. 单击导入价格。

4. 在导入窗口中，可下载文件目标并添加值。
5. 在导入窗口的相应字段上传文件。
6. 导入过程中如发生错误，导入窗口将显示错误列表和改正建议。请对文件作出必要更改，然后重新上传。

成功上传后，所指定SKU的商品的区域价格将根据文件中的价格更新。之前指定的价格将被删除。

示例：

在发布商帐户中存在用不同货币指定的多个价格以及多个区域价格。在导入的文件中，只有一个EUR价格。导入该文件后，在发布商帐户中，该商品将只有一个EUR价格。

使用API方法进行设置

• 在创建和更新虚拟物品的方法中
• 在创建和更新虚拟货币的方法中
• 在创建和更新虚拟货币套餐的方法中
• 在创建和更新捆绑包的方法中

• 在创建和更新游戏密钥套餐的方法中

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]