トラブルシューティング

ウェブのトラブルシューティング ガイドでは、次のトピックに関連する問題と質問について説明します。

登録とアクセス

統合の過程で、次のエラーが発生することがあります。このリストは、これらのエラーが発生した場合に役立つトラブルシューティングのアドバイスを提供します。

この販売者は Google Pay を利用できません
Google Pay API では、PRODUCTION 環境用に PaymentsClient を構成するサイトに Google merchantId が必要です。Google merchantId は、Google Pay & Wallet Console を介して 1 つ以上の完全修飾ドメインに関連付けられます。詳細については、返されたエラーの詳細を確認してください。
この販売者は Google Pay API を使用するための登録を完了していません。コンソール（https://pay.google.com/business/console）にアクセスしてご確認ください。
Google Pay API にウェブサイトを登録するプロセスが完了していません。本番環境へのアクセスをリクエストするを確認して、Google Pay & ウォレット コンソールを使用して登録し、Google Pay API を使用したウェブサイトの審査をリクエストします。
この販売者プロフィールはこの機能にアクセスできません
Google Pay API を使用するようにウェブサイトが構成されていません。本番環境へのアクセスをリクエストするを確認して、Google Pay & ウォレット コンソールから Google Pay API を使用したウェブサイトの審査をリクエストします。
この Google Pay API の統合は無効になっています。詳細については、Google までお問い合わせください（https://developers.google.com/pay/api/faq#how-to-get-support）。
Google にお問い合わせいただくと、Google アカウントで Google Pay API を再度有効にするために必要な手順についてご案内いたします。
ドメイン 「example.com」 はこの API を使用するように登録されていません
購入手続きがホストされているドメインが、使用している merchantId に関連付けられていません。merchantId パラメータが正しいこと、およびドメインが Google Pay & Wallet Console で登録されていることを確認します。
Google Pay API は安全なコンテキストで呼び出す必要があります。
Google Pay API は、安全なコンテキストのウェブサイトでのみ使用できます。詳細については、安全なコンテキストをご覧ください。
この販売者プロフィールの鍵が見つかりません
DIRECTtokenizationSpecification type の統合を完了するには、Google Pay & ウォレット コンソールを使用して公開暗号鍵を Google に登録する必要があります。

merchantId

統合の過程で、merchantId に関連する次のエラーが発生することがあります。このリストは、これらのエラーが発生した場合に役立つトラブルシューティングのアドバイスを提供します。

merchantId を設定する必要があります。
PaymentDataRequest 内の merchantId パラメータは、Google Pay & ウォレット コンソールを使用して指定された値に設定する必要があります。merchantId パラメータは、PRODUCTION 環境用に構成された PaymentsClient を使用する場合にのみ必要です。統合チェックリストを確認して Google Pay API を使用したウェブサイトの審査を依頼し、merchantId を取得してください。
merchantId が文字列ではありません
PaymentDataRequest 内の merchantId パラメータは常に文字列にする必要があります。API を呼び出す前に、使用する merchantId パラメータの型が文字列であることを確認してください。
merchantId が登録されていません。
PaymentDataRequest 内の merchantId パラメータは、Google Pay & ウォレット コンソールでプロビジョニングする必要があります。詳細については、本番環境へのアクセスをリクエストするをご覧ください。

ゲートウェイの有効性

統合の過程で、ゲートウェイの有効性に関連する次のエラーが発生することがあります。このリストは、これらのエラーが発生した場合に役立つトラブルシューティングのアドバイスを提供します。

不明なゲートウェイ 'yourgateway'
paymentMethodTokenizationParameters.parameters で指定したゲートウェイ パラメータは、現在 Google でサポートされていません。ゲートウェイの ID や、gatewayMerchantId などの関連フィールドについて詳しくは、ゲートウェイにお問い合わせください。
ゲートウェイ 'example' は本番環境モードで使用できません
「example」のゲートウェイ パラメータの値はテスト目的でのみ使用できます。PRODUCTION 環境用に構成された PaymentsClient では使用できません。Google Pay API で使用するために設定する必要がある PaymentMethodTokenizationSpecification パラメータ値について詳しくは、ゲートウェイにお問い合わせください。

オブジェクトの有効性

統合のどこかで、オブジェクトの有効性に関連する次のエラーが発生することがあります。このリストは、これらのエラーが発生した場合に役立つトラブルシューティングのアドバイスを提供します。

Google Pay の PaymentDataRequest が有効な json ではありません
loadPaymentData に渡されるパラメータは、常に有効な PaymentDataRequest オブジェクトでなければなりません。
transactionInfo を設定する必要があります。
PaymentDataRequest 内の transactionInfo パラメータは、常に有効な TransactionInfo オブジェクトである必要があります。

直接販売者

統合の過程で、直接販売者に関連する次のエラーが発生することがあります。このリストは、これらのエラーが発生した場合に役立つトラブルシューティングのアドバイスを提供します。

署名の検証
merchantId が間違っている場合、署名検証エラーが発生する可能性があります。これは TEST 環境で Tink paymentmethodtoken ライブラリを使用しているときに起こる場合があります。この問題を回避するには、次の YOUR_MERCHANT_ID の部分を 12345678901234567890 に設定します。
.recipientId("merchant:YOUR_MERCHANT_ID")
トークンを復号できない
Tink paymentmethodtoken ライブラリを使用してトークンを復号する場合は、次の点に注意してください。
  • Google Pay API レスポンスの環境を Tink の paymentmethodtoken 環境と一致させてください。詳しくは、次の例をご覧ください。
    • Google Pay API レスポンスが環境 TEST によって返された場合、Tink は復号のテスト環境を指します。
  • Google Pay API からのレスポンスを、Tink に渡す前に変更しないでください。Google Pay API レスポンスから返されたトークン全体を渡してください。詳しくは、次の注をご覧ください。
  • 適切な秘密鍵が、Google に登録した公開鍵に関連付けられていることを確認してください。
Windows で公開鍵と秘密鍵のペアを生成する
Windows を使用していて、 OpenSSL を使用して秘密鍵と公開鍵のペアを生成するに記載された手順に従う場合は、必ず Cygwin をマシンにインストールしてください。これは Linux コマンドを実行するために必要です。

エラー オブジェクト

エラー オブジェクトは、クライアント JavaScript メソッドからのプロミスが拒否された場合に返されるオブジェクトです。

PaymentsError
このオブジェクトには、クライアント JavaScript メソッドから返されたエラーに関する詳細情報が含まれています。エラーはユーザー向けのダイアログに表示されない場合があります。
プロパティ 型 説明
statusCode 文字列 エラーの種類を示す短いコード。
statusMessage 文字列 発生したエラーとその考えられる修正手順を説明するデベロッパー向けのメッセージ。
一般的なエラー
このオブジェクトは、すべての JavaScript メソッドで発生する可能性があるエラーを表示します。必ずデベロッパー コンソールで追加のエラー メッセージが発生していないかを確認してください。
ステータス コード 説明
BUYER_ACCOUNT_ERROR 現在の Google ユーザーは、支払い情報を提供できません。
DEVELOPER_ERROR

渡されたパラメータの形式が正しくありません。構成されたすべての環境で、なんらかのエラー メッセージがブラウザのコンソールに表示される場合があります。
MERCHANT_ACCOUNT_ERROR

Google Pay API にアクセスしているサイトに適切な権限がありません。原因としては、構成に誤りがあるか、リクエストに設定された販売者 ID が間違っていることが考えられます。詳しくは、statusMessage フィールドを確認してください。それでも問題が解決しない場合は、サポートにお問い合わせください。
INTERNAL_ERROR 一般的なサーバーエラー。

CardInfo

CardInfo 機能とは
Google Pay は、Google Pay 支払いボタンにカードが関連付けられていることをユーザーに示し、カード ブランド ネットワークとカードの下 4 桁の両方を表示します。
実装で CardInfo 機能がレンダリングされないのはなぜですか？

CardInfo 機能を動作させるには、次の条件が必要です。

  • createButton API を実装する必要があります。
  • ButtonOptions.buttonType を buy、long、pay のいずれかに構成する必要があります。
  • ユーザーは、CardParameters オブジェクトで定義されている利用可能な支払い方法を持っている必要があります。
Google Pay の支払いボタンがいつまでも読み込まれるのはなぜですか？
onLoad イベント リスナーは削除しないでください。onLoad イベント リスナーを削除すると、Google Pay の支払いボタンがいつまでも読み込まれる可能性があります。
Google Pay の支払いボタンをクリックしても、支払いプロンプトが表示されないのはなぜですか？
イベント リスナー コールバックを ButtonOptions.onClick イベントに割り当てます。

OR_BIBED_15 件のエラー

統合のどこかで OR_BIBED_15 エラーが発生することがあります。このリストでは、このエラーが発生した場合に役立つトラブルシューティングのアドバイスをいくつか紹介します。

WebView の操作
Android と iOS のガイドに沿って、統合が WebView と互換性があることを確認します。
Cross-Origin-Opener-Policy HTTP レスポンス ヘッダー
Cross-Origin-Opener-Policy HTTP レスポンス ヘッダーが same-origin に設定されている場合、ユーザーが取引を完了するために必要なポップアップがブラウザで開かなくなる可能性があります。ヘッダーの値を same-origin-allow-popups に変更して、これらの問題を軽減してみてください。
ユーザーのクリック イベントと loadPaymentData() の呼び出しの間の遅延
Google Pay ボタン（または同様の購入手続きボタン）をクリックしてから loadPaymentData() 呼び出しまでの間に遅延が発生すると（例: setTimeout()、追加のネットワーク呼び出し、同様の長時間実行ロジック）、ブラウザのポップアップ ブロック メカニズムがトリガーされる可能性があります。 ユーザーのクリックと loadPaymentData() 呼び出しの間に遅延を設定しないことをおすすめします。