项目概览

1. 在华为确认应用内购买服务

1. 1
   选择将要接入涨米的 HarmonyOS 应用

   同一开发者账号下可能有多个项目和应用，先核对应用名称与包名，避免复制到其他应用的 App ID。

2. 2
   开通应用内购买服务

   只做测试可按华为页面提示开通沙盒调测；正式销售数字商品还需要开通商户服务并完成相关协议。

2. 在华为找到并复制 App ID

1. 1
   进入应用所在的项目

   从“开发与服务”的项目列表进入项目，先核对项目名称和目标 HarmonyOS 应用，避免读取到同一账号下的其他应用。

2. 2
   打开“项目设置 → 常规”

   在页面的“应用”区域找到目标应用；如果项目下有多个应用，请再次核对应用名称和包名。

3. 3
   复制标号 1 所在行的“APP ID”

   点击 APP ID 右侧的复制图标并完整复制。不要复制上方的“包名”，也不要复制标号 2 的“OAuth 2.0 客户端 ID（凭据）”。

3. 在涨米创建项目并粘贴 App ID

1. 1
   点击项目切换器中的“创建新项目”

   项目名称使用产品名称即可。一个项目代表一款产品，用户、权益、商品组合和分析都按项目隔离。

2. 2
   确认应用名称与项目名称一致

   应用名称由涨米自动使用项目名称，不需要再次填写。“鸿蒙”会作为独立的平台标识显示在名称下方和应用选择器中。

3. 3
   把刚复制的 APP ID 粘贴到“华为应用编号（App ID）”

   粘贴后检查首尾没有空格。该值负责把华为商品、订单和通知归到当前涨米应用。

4. 4
   先不要点击保存

   继续向下填写同一表单中的“服务端订单验证”，第 2 步结束时再一次保存整个应用。

1. 先检查涨米中是否已有对应密钥

1. 1
   打开应用设置中的“服务端订单验证”

   展开“华为 IAP 密钥配置”，点击“选择密钥”。

2. 2
   核对 Issuer ID、Key ID 和配置名称

   如果已有当前华为开发者账号的配置，直接选择它。Issuer ID 应与开发者账号一致，Key ID 必须对应已上传的私钥文件。

3. 3
   已有配置时直接选择并保存

   选择对应配置后保存应用，订单验证会自动启用，然后跳到下一步。无需再次进入华为创建或下载密钥。

2. 没有对应配置时，再到华为准备密钥

1. 1
   向下滚动到“服务端密钥管理”

   先复制密钥列表上方的 Issuer ID。它属于当前华为开发者账号，同一账号下的不同应用共用；它不是 App ID，也不是 API 客户端 ID。

2. 2
   确认是否仍保留现有密钥文件

   如果本地安全存储中保留了列表内某个密钥的文件，可以直接使用该行的 Key ID；没有文件时再点击“创建密钥”。

3. 3
   需要新建时点击右侧“创建密钥”

   密钥名称只能使用字母、数字和下划线，最长 50 个字符，例如 zhangmi_server，然后点击“生成”。

4. 4
   复制新密钥所在行的“密钥 ID”

   这个值对应涨米的“密钥编号”。请从同一行复制，避免与已有密钥混淆。

5. 5
   点击该行“下载密钥”

   确认弹窗后立即下载并安全保存。华为私钥只允许下载一次；如果遗失，需要创建新密钥。

3. 回到涨米添加密钥配置

选择密钥

如果列表中已有当前华为开发者账号的密钥，直接选择；Issuer ID、Key ID 和私钥会由这个账号下的不同应用共用。

添加新的密钥配置

只有列表中没有对应开发者账号时才选择此项，并填写一个容易识别的配置名称。

填写并上传

填写账号级 Issuer ID、Key ID，再选择或拖入华为下载的私钥文件，无需打开文件。

保存并自动启用

点击页面底部的“保存应用”，涨米会自动启用服务端订单验证；密钥未选择完整时不能保存。

1. 在涨米复制通知地址

1. 1
   打开“应用”，进入刚保存的鸿蒙应用

   向下找到“事件通知”。如果仍显示“保存应用后自动生成”，说明上一步尚未保存成功。

2. 2
   点击“复制地址”

   不要手工拼接或修改地址末尾的随机标识；项目和应用改名不会改变这条地址。

2. 在华为打开关键事件通知

1. 1
   打开“订单/订阅关键事件通知”开关

   华为会在购买、续订、关闭自动续订、到期、退款或撤销等关键状态变化时发送通知。

2. 2
   把涨米地址粘贴到“生产环境服务器地址”并保存

   “沙盒环境服务器地址”可以留空。华为官方说明：只配置生产地址时，生产与沙盒通知都会发送到该地址。

3. 3
   发送测试通知并检查涨米记录

   回到涨米“通知记录”，确认测试通知已出现且状态为“已处理”。如果没有出现，先检查地址是否完整、是否为 HTTPS。

1. 在华为找到 API 客户端入口

2. 按最小权限创建 API 客户端

1. 1
   名称

   填写便于识别的名称，例如 zhangmi_catalog。

2. 2
   “项目”选择当前应用所属的华为项目

   不要保留为 N/A。API 客户端需要绑定实际项目，否则调用 PMS 接口时可能返回权限错误。

3. 3
   角色只选择“运营”

   PMS v2 商品查询接口允许运营角色调用，这是当前可用角色中权限较小的一项；不要额外添加 APP 管理员、管理员、开发、财务、客服或法务角色。

4. 4
   创建后立即复制客户端 ID 与密钥

   华为会直接显示这两个字符串，不会为 Connect API 的 API 客户端下载密钥文件。请分别复制到安全位置。

3. 在应用设置中选择或添加商品导入连接

其他项目已保存过连接时，可直接在“选择商品导入连接”中选用，无需再次填写密钥。请确认该客户端有权读取当前华为应用；保存后各应用可独立修改。没有可用连接时，按以下步骤添加。

1. 1
   打开“项目设置 → 应用”并进入刚才的鸿蒙应用

   在“商品导入连接”中确认平台和华为 App ID，再配置当前应用的目录连接。

2. 2
   先填写 API 客户端 ID

   把华为后台显示的客户端 ID 完整粘贴到第一个输入框，不要填写 App ID、Issuer ID 或 Key ID。

3. 3
   再填写同一 API 客户端的密钥

   把华为创建完成页面显示的密钥完整粘贴到下方密码输入框，不要填写 Service Account 私钥或 IAP 服务端私钥。

4. 4
   点击“保存导入配置”

   保存成功后密钥会加密存储且不再回显；以后不更换 API 客户端时，密钥输入框留空即可。

5. 5
   回到“商品”页面并点击“立即导入”

   商品编号、名称、类型、价格和币种从华为同步。重复导入会更新现有记录，不会制造重复商品。

1. 先在华为确认要导入的商品

1. 1
   确认页面顶部显示的是目标应用

   商品列表按华为应用区分。如果应用选错，涨米使用当前 App ID 导入时将得不到这张列表中的商品。

2. 2
   核对商品 ID、类型、价格和状态

   这些字段将从华为读取。发现错误时请在华为后台修改，再回涨米重新导入；涨米不允许手工创建华为商品。

3. 3
   确认需要销售的商品已经生效

   草稿、未提交或未满足华为发布条件的商品，可能不会出现在可读取的目录中。

2. 回到涨米检查导入商品

1. 1
   核对华为同步字段

   商品编号、名称、类型、价格和币种只读，以华为商品详情为准。下图展示了华为这些字段所在的位置。

2. 2
   为非续期订阅设置权益周期

   点击该商品右侧“设置周期”，选择 1 周、1/2/3/6 个月、1/2 年或永久。华为目录目前不返回涨米需要的权益时长，因此必须在涨米补充。

3. 3
   理解商品状态

   商品是否上架由华为商店状态决定，涨米不再设置第二个启用开关。商品下架后，涨米仍会保留映射并正确校验历史订单、续订和退款。

3. 创建稳定权益（Entitlements）并关联商品

1. 1
   打开“权益”，点击“创建权益”

   权益标识用于客户端判断访问权限，例如 premium；确定后应保持稳定，不要把具体商品编号当作权益标识。

2. 2
   按平台选择可以解锁权益的商品

   商品会按“鸿蒙、苹果”等平台分组，并显示各自的商品 ID。同一权益可以同时关联多个平台的月度、年度或永久商品。

4. 配置前端展示的商品组合（Offerings）

1. 1
   打开“商品组合”，点击“创建商品组合”

   创建一个默认组合并设为“当前商品组合”，客户端会优先获取当前组合。

2. 2
   添加套餐项（Packages）

   一个套餐项代表前端中的一个售卖位置，例如 monthly 或 annual。同一个套餐项可以分别关联鸿蒙和苹果的对应商品；SDK 只返回当前平台对应的商品。

3. 3
   只勾选希望前端展示的商品

   商品存在于 Products 并不代表必须展示。前端读取当前 Offering 后，只展示其中 Packages 关联的商品；修改组合无需重新发布客户端。