トラブルシューティング

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 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 までお問い合わせください。
アカウントで Google Pay API を再度有効にする手順については、Google までお問い合わせください。
この API を使用するには、Google Play 開発者サービス ライブラリのバージョン 8.4 以降が必要です
アプリを実行している端末の Google Play 開発者サービスが最新の状態かどうか確認してください。
この販売者プロフィールの鍵が見つかりません
DIRECT tokenizationSpecification type の統合を行うには、Google Pay デベロッパー プロフィールを使用して公開暗号鍵を Google に登録する必要があります。統合チェックリストを確認して Google Pay API を使用したアプリの審査を依頼し、公開暗号鍵を送信してください。

ゲートウェイの有効性

不明なゲートウェイ 'yourgateway'
tokenizationSpecification で指定された gateway プロパティの値が、現時点では Google Pay API でサポートされていません。ゲートウェイ ID や関連フィールド(gatewayMerchantId など)について詳しくは、ゲートウェイにお問い合わせください。
ゲートウェイ 'example' は本番環境モードで使用できません。
「example」のゲートウェイ プロパティの値はテスト目的でのみ使用できます。WalletOptions 環境パラメータの値が WalletConstants.ENVIRONMENT_PRODUCTION に設定されている場合、example のゲートウェイ プロパティ値は使用できません。Google Pay API で使用する gateway プロパティについて詳しくは、ゲートウェイにお問い合わせください。

直接販売者

署名の検証
merchantId が間違っている場合、署名検証エラーが発生する可能性があります。これは TEST 環境で Tink ライブラリを使用しているときに起こる場合があります。この問題を回避するには、次の YOUR_MERCHANT_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 コマンドを実行するために必要です。