Android 疑難排解指南包含與下列錯誤類型相關的問題:
無法辨識的應用程式
當使用者從付款詳細資訊對話方塊中選擇付款卡時,使用者可能會看見下列訊息:
無法辨識應用程式。請確認您信任這個應用程式再繼續。
這個錯誤指出應用程式正在使用 ENVIRONMENT_TEST
,且沒有收到真實的付款憑證,但會在提出要求之後收到個人資訊,例如帳單地址、帳單地址電話號碼、運送地址和電子郵件地址。
要求失敗
最常見的錯誤訊息是 ERROR_CODE_DEVELOPER_ERROR
。這個錯誤訊息也會在 UI 中顯示為具有下列文字的對話方塊:
要求失敗
發生未預期的錯誤。請稍後再試。
如要深入瞭解這個錯誤,步驟如下:
- 確定您的電腦上安裝了 ADB。如需詳細資訊,請參閱 Android Debug Bridge (adb)。
- 確保您的裝置已經啟用 USB 偵錯。如需詳細資訊,請參閱偵錯應用程式。
- 使用 USB 傳輸線將手機連接至電腦。
在電腦上的終端機或命令提示字元中執行下列指令:
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 指令。