注册基于网络的付款应用

了解如何在注册期间配置基于网络的付款应用。

Eiji Kitamura
Eiji Kitamura

基于网络的付款应用是渐进式 Web 应用 (PWA),在Service Worker 上运行。付款应用中的 Service Worker 发挥着重要作用,因为它可捕获来自商家的付款请求、启动付款应用,以及调解与商家的通信。

如需配置基于网络的付款应用,您需要注册可用的付款方式和 Service Worker。您可以使用 Web 应用清单以声明方式配置基于网络的付款应用。

浏览器支持

Web Payments 包含一些不同的技术,支持状态取决于浏览器。

Chromium Safari Firefox
桌面设备 Android 桌面设备 移动设备 桌面设备/移动设备
Payment Request API
付款处理程序 API
iOS/Android 付款应用 ✔* ✔*

使用 Web 应用清单配置付款应用

如需以声明方式配置基于网络的付款应用,请提供 Web 应用清单

Web 应用清单中的以下属性与基于网络的付款应用相关:

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

请参阅设置付款方式,确保您的付款方式清单正确指向您的 Web 应用清单。

即时注册 Service Worker (JIT)

JIT 注册只需提供 Web 应用清单,无需进行额外的编码。如果您已配置 Web 应用清单并正确提供,则应该一切准备就绪。浏览器将处理其余工作。

调试基于网络的付款应用

在开发基于网络的付款应用前端时,您可能会在商家上下文和付款应用上下文之间切换。以下调试提示有助于您在 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 的开发者工具将本地网络服务器转发至 Android 设备,并在移动浏览器中测试其运行情况。如需了解如何执行此操作,请参阅访问本地服务器

通过桌面开发者工具远程调试 Android Chrome 上的网站

您还可以在桌面开发者工具上调试 Android Chrome。如需了解如何执行此操作,请参阅 Android 设备远程调试入门

付款处理程序事件日志记录

DevTools 可以显示 Payment Handler API 事件,以简化本地开发。在商家上下文中打开开发者工具,然后前往 Application 窗格下的“付款处理程序”部分。选中“显示来自其他网域的事件”,然后点击“记录”按钮,即可开始捕获发送到处理付款的 Service Worker 的事件。

付款处理程序事件日志记录的屏幕截图。
付款处理程序事件日志记录。

后续步骤

下一步是了解 Service Worker 如何在运行时编排付款事务。