ウェブベースの支払いアプリの登録

登録時にウェブベースのお支払いアプリを設定する方法を学びます。

ウェブベースの決済アプリはプログレッシブ ウェブアプリ(PWA)であり、サービス ワーカー上で実行されます。決済アプリの Service Worker は、販売者からの支払いリクエストの取得、決済アプリの起動、販売者との通信の仲介で重要な役割を果たします。

ウェブベースの支払いアプリを構成するには、利用可能な支払い方法と Service Worker を登録する必要があります。ウェブベースのお支払いアプリは、ウェブアプリ マニフェストを使用して宣言的に設定できます。

ウェブ決済は複数の異なるテクノロジーで構成されており、サポート状況はブラウザによって異なります。

Chromium Safari Firefox
パソコン Android パソコン モバイル パソコン / モバイル
Payment Request API
Payment Handler API
iOS / Android の決済アプリ ✔* ✔*

ウェブアプリ マニフェストを使用して支払いアプリを構成する

ウェブベースの支払いアプリを宣言的に構成するには、ウェブアプリ マニフェストを提供する

ウェブアプリ マニフェストの次のプロパティは、ウェブベースの支払いアプリに関連しています。

  • name
  • icons
  • serviceworker
    • src
    • scope
    • use_cache

お支払い方法の設定で、お支払い方法のマニフェストがウェブアプリ マニフェストを正しく参照していることを確認します。

Service Worker ジャストインタイム(JIT)の登録

JIT 登録では、ウェブアプリ マニフェストの提供のみが必要で、追加のコーディングは必要ありません。ウェブアプリ マニフェストをすでに設定していて、適切に配信されている場合は、これで完了です。残りはブラウザで処理します。

ウェブベースのお支払いアプリのデバッグ

ウェブベースの支払いアプリのフロントエンドを開発する場合、販売者のコンテキストと支払いアプリのコンテキストを行き来することになります。次のデバッグ ヒントは、Chrome での開発に役立ちます。

ローカルサーバーで開発する

開発にはどのサーバーを使用していますか?多くのデベロッパーは、localhost または社内サーバー環境を使用しますが、ブラウザの高度な機能には安全な環境(HTTPS)と有効な証明書が必要になるため、これは難しい場合があります。Payment Request API と Payment Handler API も例外ではなく、通常、localhost や社内サーバーに有効な証明書は付属していません。

ただし、Chrome など一部のブラウザでは、http://localhost の証明書はデフォルトで除外されます。Chrome でも、Chrome インスタンスを起動することで証明書の要件を免除できます。たとえば、要件を http://*.corp.company.com から除外するには、次のフラグを使用します。

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Windows

chrome.exe --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

ランタイム フラグを使用して Chrome を実行する方法については、フラグを使用して Chromium を実行するをご覧ください。

ローカル サーバーのポート転送

Chrome の DevTools を使用してローカル ウェブサーバーを Android デバイスにポート転送し、モバイル ブラウザから動作をテストできます。方法については、ローカル サーバーにアクセスするをご覧ください。

パソコン版デベロッパー ツールから Android Chrome のウェブサイトをリモートでデバッグする

デスクトップ版 DevTools で Android Chrome をデバッグすることもできます。その方法については、Android デバイスのリモート デバッグを使ってみるをご覧ください。

支払いハンドラのイベント ロギング

DevTools で Payment Handler API イベントを表示して、ローカル開発を容易にできます。販売者のコンテキストで DevTools を開き、[Application] ペインの [Payment Handler] セクションに移動します。[他のドメインのイベントを表示] をオンにして [記録] ボタンをクリックすると、支払いを処理するサービス ワーカーに送信されるイベントのキャプチャが開始されます。

Payment Handler イベントのロギングのスクリーンショット。
Payment Handler イベントのロギング。

次のステップ

次のステップでは、Service Worker が実行時に支払いトランザクションをオーケストレートする方法を確認します。