如需预配新的酒店钥匙,用户必须在其设备上完成身份验证和关联流程。这会将其外部用户账号与 Google 钱包账号相关联。本文档概要介绍了在不同平台上执行该过程的流程。
通过 Android 应用添加到 Google 钱包
在本部分中,我们将介绍如何从服务提供商的 Android 应用将卡片保存到 Google 钱包。
用户流
以下图展示了从 Google 钱包的角度预配酒店钥匙的用户流程。
图 1:用户开始预配卡片并接受服务条款。
在网络连接和初始服务配置期间,系统会向用户显示旋转的连接动画。
完成后,用户接受《服务条款》并继续完成流程。
图 2:用户配置完成。
在后台服务在设备上预配账号时,系统会向用户显示旋转的保存动画。
服务完成后,系统会显示一条成功消息。
如果用户设备上尚未安装 Google 钱包应用,系统可能会在后续屏幕中提示用户下载该应用。
要点
如果卡已保存到所选的 Google 账号,系统会改为显示一个链接,以便用户在 Google 钱包应用中打开该卡,在其中查看卡的详细信息。
如果卡片保存到用户登录的 Google 账号以外的账号,系统会向用户发送一条消息,指明另一个 Google 账号已保存该卡片。
如果用户尝试添加卡片但没有 Google 账号,系统会显示创建账号的提示。创建 Google 账号后,流程会照常继续。
支持酒店房卡流程的应用需要与 Google Play 服务 API 集成。不过,公开分发的 Google Play 服务中不提供从服务提供商应用调用 Google Play 服务的方法。服务提供商应用开发者必须添加自定义模块并获得对其的访问权限,才能调用某些方法。如需了解详情,请与您的服务提供商联系。
支持酒店房卡流程的应用需要与 Google Play 服务 API 集成。不过,公开分发的 Google Play 服务中不提供从服务提供商应用调用 Google Play 服务的方法。服务提供商应用开发者必须添加自定义模块并获得对其的访问权限,才能调用某些方法。如需了解详情,请与您的服务提供商联系。
通过网站添加到 Google 钱包
本部分介绍了从发卡机构网站将卡保存到 Google 钱包的流程。
第 1 步:登录网站
流程的第一步是登录发卡机构的网站,然后选择“添加到 Google 钱包”按钮。
图 3:用户登录网站并前往“添加到 Google 钱包”按钮。
第 2 步:使用 Google 账号登录
用户完成“使用 Google 账号登录”操作后,会在发卡机构的网站上看到一个加载屏幕,然后在下一步中被重定向到 Google 钱包。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eHotel Key provisioning requires users to authenticate and link their external account to Google Wallet.\u003c/p\u003e\n"],["\u003cp\u003eUsers can add Hotel Keys to Google Wallet from Android apps, Wearables (initiated from a phone), and websites.\u003c/p\u003e\n"],["\u003cp\u003eThe provisioning process involves accepting terms of service and may require creating a Google Account if one doesn't exist.\u003c/p\u003e\n"],["\u003cp\u003eService providers may need to integrate with custom Google Play services modules for certain functionalities.\u003c/p\u003e\n"],["\u003cp\u003eWearable provisioning is subject to service provider availability and limitations, such as single Wearable provisioning.\u003c/p\u003e\n"]]],["Users provision a Hotel Key by authenticating and associating their account with Google Wallet. From an Android app, users select \"Add to Google Wallet,\" accept terms, and complete provisioning. Wearable provisioning is initiated from the phone. On a website, users sign in, select \"Add to Google Wallet,\" then sign in with Google and complete provisioning. If a card already exists, users are shown a link to it. A Google account is required; if they dont have one they must create it.\n"],null,["# Provision a new card\n\nTo provision a new Hotel Key, the user must complete an authentication\nand association flow on their device. This links their external\nuser account to a Google Wallet account.\nThis document describes that process at a high level across different surfaces.\n\nAdd to Google Wallet from an Android app\n----------------------------------------\n\nIn this section, we describe the flow to save a card to\nGoogle Wallet from a Service Provider's Android app.\n\n### User flow\n\nThese figures illustrate the user flow to provision a Hotel Key from a\nGoogle Wallet perspective.\n| **Note:** Before this flow begins, the user must authenticate within the Service Provider's app. Next, they must select the [Add to Google Wallet](/wallet/access/hotel-key/get-started/brand-guidelines#add-to-google-wallet-button) button. If the user doesn't have a Google Account, they complete a flow to create one and then continue the flow to provision their card.\n**Figure 1**: A user begins to provision their card and accepts the Terms of Service.\n\n\n- A spinning connection animation is shown to the user while network connectivity and initial services configure.\n- After this completes, the user accepts the Terms of Service and continues with the flow.\n\n\u003cbr /\u003e\n\n**Figure 2**: User provisioning completes.\n\n\n- A spinning save animation is shown to the user while background services provision the account on the device.\n- After the services complete, a success screen appears.\n- The user might be prompted in subsequent screens to download the Google Wallet app, if it doesn't already exist on their device.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n### Key points\n\n- If the card is already saved to the selected Google Account, the user is instead shown a link to open the card in the Google Wallet app, where they can view card details.\n- If the card is saved to a Google Account other than the one the user is logged into, the user receives a message that indicates another Google Account has already saved that card.\n- If the user attempts to add a card and doesn't have a Google Account, a prompt to create an account appears. After creation of the Google Account, the flow continues normally.\n- Apps that support Hotel Key flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet on a Wearable from an Android app\n------------------------------------------------------\n\nUsers can provision to their Wearables by initiating the provisioning flow on\ntheir phone and selecting a single Wearable, as seen in this figure:\n**Figure 1**: Wearable provisioning flow.\n\n### Key points\n\n- Provisioning to a Wearable requires a phone capable of provisioning a card.\n- Users can provision to their phone and Wearable in a single flow, or they can restart the flow to add it to a Wearable after the first provisioning to their phone is complete.\n- Users should be limited by the Service Provider to provisioning only a single Wearable.\n- Inquire with your Service Provider about the availability of Wearable provisioning.\n- Apps that support Hotel Key flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet from a Website\n-----------------------------------\n\nThis section describes the flow to save a card to Google Wallet from\nan issuer's website.\n\n### Step 1: Sign in to Website\n\nThe first step in the flow is to sign in to the issuer's website and select\nthe Add to Google Wallet button.\n**Figure 3**: A user logs into a website and navigates to the Add to Google Wallet button. **Important:** Google requires that your website authenticates users before you show the Add to Google Wallet button. Sending the user an email with a \"secret\" link is not sufficient authentication.\n\n### Step 2: Sign in with Google\n\nThe user completes Sign in with Google and then sees a loading screen\non the issuer's website before being redirected to Google Wallet in the next\nstep.\n**Figure 3**: A user chooses a Google Account to link to their Hotel Key. **Note:** You can download this [loading gif](/static/wallet/access/images/web-provisioning-loading.gif) for use on your website's loading page if you would like to match the Google Wallet loading screen.\n\n### Step 3: Complete Provisioning\n\nThe user completes the provisioning flow within Google Wallet.\n**Figure 3**: A user continues with provisioning, accepts terms of service, and completes the flow."]]