注册基于网络的付款应用

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

基于网络的付款应用属于渐进式 Web 应用 (PWA),并在服务工作器上运行。付款应用中的服务工具有重要作用,因为它会捕获来自商家的付款请求、启动付款应用,并协调与商家的通信。

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

浏览器支持

Web Payments 由几项不同的技术组成,支持状态取决于浏览器。

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

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

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

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

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

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

即时注册 Service Worker (JIT)

JIT 注册只需提供网站应用清单,无需额外编码。如果您已配置网络应用清单并正确提供该清单,则应该可以顺利完成设置。其余工作将由浏览器处理。

调试基于网络的付款应用

开发基于 Web 的付款应用前端时,您可能会在商家上下文和付款应用上下文之间跳转。以下调试提示有助于您在 Chrome 上获得良好的开发体验。

在本地服务器上开发

您使用哪台服务器进行开发?许多开发者倾向于使用 localhost 或公司内部服务器环境,这具有挑战性,因为浏览器中强大的功能往往需要安全环境 (HTTPS) 和有效证书。Payment Request API 和 Payment Handler API 也不例外,本地主机或公司内部服务器通常不附带有效的证书。

好消息是,某些浏览器(包括 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 的开发者工具将本地 Web 服务器转发到 Android 设备,并通过移动浏览器测试其运行情况。如需了解具体方法,请参阅访问本地服务器

通过桌面版 DevTools 在 Android Chrome 上远程调试网站

您还可以在桌面版 DevTools 中调试 Android Chrome。如需了解如何执行此操作,请参阅 Android 设备远程调试入门

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

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

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

后续步骤

下一步是了解服务工件如何在运行时协调付款交易。