请先参考“应用开发准备”完成基本准备工作和指纹配置,再继续以下开发活动。
登录AppGallery Connect,点击“开发与服务”。

选择对应项目。

选择“钱包服务”,点击“申请服务”。

点击“点击申请”,并选择新版本。


配置Wallet Kit服务参数:服务类型选择钥匙,服务子类型选择酒店卡,服务项目按需选择,并指定服务号、开发者服务公钥及开发者云侧服务地址前缀后,点击“下一步”。

| 参数 | 说明 |
|---|---|
| 服务名称 | Wallet Kit首页列表展示该开发者所有创建的服务时,服务名称用于区分不同的服务。建议命名为公司简称+Wallet Kit+应用场景,长度不超过64个字符。 |
| 服务类型 | 固定选择“钥匙”。 |
| 服务子类型 | 固定选择“酒店卡”。 |
| 服务项目 | 选择接入的服务项目。 |
| 默认卡名称 | 在钱包内显示的默认卡名称 ,长度不超过64个字符。 |
| 服务号 | 开发者服务号,用于区分不同的项目和服务。建议格式为【hwpass.公司简称.项目名称.pass.服务项目】,须以hwpass开头 (自动填充,无需输入),可为数字、字母,长度不超过32个字符。 |
| 服务公钥 | Wallet Kit服务器认证开发者身份的凭证。依据页面上的"公钥操作步骤指导说明"生成公钥并回填。 |
| 服务器地址前缀 | 开发者服务器地址,用于Wallet Kit服务器在开卡或删卡成功后回调开发者。如果不需要回调结果,可以不填该字段。 |
配置NFC&二维码参数。

| 参数 | 说明 |
|---|---|
| 卡片激活设备限制 | 用于控制设备激活限制。 单设备专属:激活后仅限当前设备使用,更换需解绑。 多设备共享:统一账号下支持多台设备同时激活。 |
| 是否开通NFC能力 | 固定选择“是”。 |
| 应用ID | 通过“获取AID”按钮创建新应用ID,内容格式为16进制数(字符为 0-F),最大长度为32(推荐32位)。 |
| 外部认证密钥 | 用于离线读写卡时外部认证校验。内容格式为16进制数(字符为 0-F),最大长度为32(推荐32位)。 |
| 文件参数定义 | 密钥信息,用于对指定文件区域读写权限的控制。内容格式为16进制数(字符为 0-F),最大长度为32(推荐32位)。 |
| 是否需展示二维码 | 固定选择“否”。 |
配置添加预览信息:按要求上传卡面底图。

配置卡详情页信息:按需配置卡面个性化信息,功能区,运营区以及官方App/元服务跳转。
个性化信息配置:

| 参数 | 说明 |
|---|---|
| 是否展示前缀 | 是否需要展示个性化字段的前缀(如:“号码:8888”),如需展示,可以自定义前缀名称,勾选字段后可预览效果。 |
| 文字颜色 | 个性化字体颜色,可以用左边的选色版选色也可以自己编辑要求6位十六进制色值,以#开头,建议用默认值#ffffff。 |
| 文字位置 | 用于控制个性化信息在卡面展示的位置,有靠近底部和居中两种位置选择。 |
| 字段位置 | 按需勾选需要的字段,按需配置前缀值(如果勾选展示前缀),文字大小(建议默认值14),填写示例值,右边可以看到预览效果。 |
功能区配置:按需配置详情页功能。

| 参数 | 说明 |
|---|---|
| 刷卡 | 支持刷酒店门禁及梯控能力。 |
| 查房间号 | 查询当前预定房间的房间号。 |
| 卡片信息 | 用于展示卡面提供服务方(按需配置多语言)信息,按需勾选卡号和联系客服(客服电话方便用户联系)。在详情页点击卡面信息会跳转卡面信息展示。右边可以看到预览效果。 |
| 删除 | 支持钱包内删卡。 |
运营区配置:可以按需配置服务菜单(最多支持5个),是否提供使用记录查看链接,选择后按照提示配置即可,右边可以查看配置的预览效果。

| 参数 | 说明 |
|---|---|
| 服务菜单 | 用于控制详情页的运营区。如果需要配置,点添加按钮后需要配置菜单名称(多语言可选)以及跳转地址。 |
| 是否提供使用记录查看链接 | 用于控制详情页的运营区是否展示使用记录。 |
| 是否提供华为服务号入口 | 控制详情页的运营区的服务号是否展示,如果需要配置,则填写开通服务号的ID和名称。 |
官方App/元服务跳转配置:按需配置官方App/元服务跳转,如果选择是,需要按需配置跳转链接,右边可以查看配置的预览效果。

提交前进行信息核对及预览,确认无误后,点击“提交”完成酒店房卡Wallet Kit服务接入配置。
