注册基于网络的付款应用

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

基于网络的付款应用是渐进式 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 如何在运行时编排付款事务。