疑難排解

Android 疑難排解指南包含與下列錯誤類型相關的問題：

無法辨識的應用程式

當使用者從付款詳細資訊對話方塊中選擇付款卡時，使用者可能會看見下列訊息：

無法辨識應用程式。請確認您信任這個應用程式再繼續。

這個錯誤指出應用程式正在使用 ENVIRONMENT_TEST，且沒有收到真實的付款憑證，但會在提出要求之後收到個人資訊，例如帳單地址、帳單地址電話號碼、運送地址和電子郵件地址。

要求失敗

最常見的錯誤訊息是 ERROR_CODE_DEVELOPER_ERROR。這個錯誤訊息也會在 UI 中顯示為具有下列文字的對話方塊：

要求失敗
發生未預期的錯誤。請稍後再試。

如要深入瞭解這個錯誤，步驟如下：

  1. 確定您的電腦上安裝了 ADB。如需詳細資訊，請參閱 Android Debug Bridge (adb)。
  2. 確保您的裝置已經啟用 USB 偵錯。如需詳細資訊，請參閱偵錯應用程式。
  3. 使用 USB 傳輸線將手機連接至電腦。

  4. 在電腦上的終端機或命令提示字元中執行下列指令：

    adb -d logcat -s WalletMerchantError

回應會指示錯誤的基本原因。例如，您可能會看到：

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This merchant profile does not have access to this feature.

您需要採取來解決問題的動作取決於錯誤訊息。

註冊與存取權

您尚未註冊為使用這個 API。
您尚未完成針對 Google Pay API 註冊應用程式的程序。請檢閱我們的整合檢查清單，以註冊並要求檢閱應用程式對 Google Pay API 的使用方式。
這個商家資料無法存取這項功能。
Google 尚未將您的應用程式設定為使用 Google Pay API。請檢閱我們的整合檢查清單，要求檢閱應用程式對 Google Pay API 的使用方式並納入白名單。
簽署金鑰指紋 {11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55} 與我們的這個應用程式的記錄不符。
如果使用正確的簽署金鑰簽署 APK，Google Pay API 只能在正式操作模式下使用。如需詳細資訊，請參閱簽署應用程式。
如要使用這個 API，您必須將以下代碼新增至您的資訊清單：
如要啟用 Google Pay API，必須修改您的 AndroidManifest.xml。如需詳細資訊，請參閱修改您的資訊清單。
已停用這個商家。如需詳細資訊，請與我們聯絡。
與我們聯絡，進一步瞭解為您的帳戶重新啟用 Google Pay API 的必要步驟。
這個 API 需要 Google Play 服務程式庫 8.4+ 版
請確保在執行應用程式的裝置上，Google Play 服務是最新版本。
找不到這個商家資料的金鑰
您必須透過 Google Pay 開發人員設定檔向 Google 註冊您的公開加密金鑰，才能完成 DIRECT tokenizationSpecification type 整合作業。請參閱我們的整合檢查清單，將您的應用程式對 Google Pay API 的使用方式送交審核，並提交您的公開加密金鑰。

閘道有效性

不明閘道「yourgateway」
Google Pay API 目前不支援您在 tokenizationSpecification 中指定的 gateway 屬性值。如要進一步瞭解閘道 ID 和相關欄位 (例如 gatewayMerchantId)，請與您的閘道聯絡。
閘道「範例」無法在正式上線模式中使用。
範例閘道的屬性值僅供測試使用，無法與設定為下列參數值的 WalletOptions 環境參數搭配使用：WalletConstants.ENVIRONMENT_PRODUCTION。如要進一步瞭解您需要搭配 Google Pay API 使用的 gateway 參數，請與您的閘道聯絡。

直接商家

簽名驗證
如果 merchantId 有誤，您可能會遇到簽名驗證錯誤。當您在 TEST 環境中使用 Tink 程式庫時，就可能會發生這種情況。如要避免發生這個問題，請將下列程式碼的 <您的商家 ID>替換成 01234567890123456789：
.recipientId("merchant:YOUR_MERCHANT_ID")
無法解密代碼
如果您使用 Tink 程式庫來解密代碼，請注意下列事項：
  • 確認 Google Pay API 回應環境與 Tink 環境相對應。詳情請參閱以下示例：
    • 如果 Google Pay API 回應是由 ENVIRONMENT_TEST 傳回，則 Tink 會指向測試環境來進行解密。
  • 在系統將 Google Pay API 回應傳送至 Tink 之前，請勿修改相關內容。另外，請一併確保您傳送的是 Google Pay API 回應所傳回的完整代碼。詳情請參閱以下注意事項：
  • 確認您擁有的私密金鑰與您先前透過 Google 註冊的公開金鑰相關聯。
在 Windows 系統中產生公開和私密金鑰組
如果您使用 Windows 系統，並且希望根據使用 OpenSSL 產生私密與公開金鑰組中提及的步驟操作，請確認您已經電腦上安裝 Cygwin，這樣您才能執行 Linux 指令。