Stripe Terminal JavaScript SDK 在连接到互联网读卡器时遇到 DNS 错误

注意:如果您经常遇到因 DNS 问题引起的连接问题,建议您了解一下服务器驱动的集成模式,因为该模式使用 Stripe API 作为用户销售终端与读卡器之间的媒介。


概览

某些 DNS 提供商会阻止本地 IP 地址的 DNS 解析。您可以转到读卡器上的设置并选择“诊断”,然后查看 DNS 解析测试结果,以检查 DNS 解析是否成功。Stripe Terminal 使用部分限定域名 *.[random-string].device.stripe-terminal-local-reader.net,该域名可解析为 BBPOS WisePOS E 或 S700 的本地 IP 地址。如果 DNS 提供商阻止本地 IP 解析,则更改网络设置以使用以下 DNS 提供商之一:

请注意,这只会影响 Stripe Terminal JavaScript SDK,因此如果您使用服务器驱动的集成模式或我们的任何移动 SDK(Android、iOS、React Native)来与我们的智能读卡器通信,这不会对您产生任何影响。

如果您需要更改 DNS 设置:

如果您可以获取路由器设置,我们建议在您接受线下付款所在位置的路由器上进行此更改。这样一来,该位置的所有设备都将收到正确的 DNS 配置。

否则,请根据您的销售终端设备按照以下说明操作。

更改路由器上的 DNS:

如果您有多台智能读卡器,可能最好是在网络路由器上修改 Wi-Fi 的 DNS,以避免需要在每个销售终端上逐一修改 DNS 设置。将路由器的 DNS 更改为上面列出的任何知名提供商应该不会对您的任何常规互联网流量产生影响。

此处提供了有关更改路由器上的 DNS 设置的示例说明。

更改设备上的 DNS:

Microsoft Windows:

如果您使用 Windows 计算机作为销售终端,请按照此处此处列出的步骤更改 DNS 设置。注意:您可能需要设备管理员权限才能修改 DNS 设置。您需要更改每台 Windows 计算机上与 Stripe Terminal 配合使用的 DNS。

苹果设备:

如果您使用的是 Mac,请按照以下步骤在 macOS 中更改您的销售终端 DNS 设置。如果您使用的是 iPad,请按照以下步骤进行操作。注意:您可能需要设备管理员权限才能修改 DNS。您需要更改用作销售终端的每个浏览器上的 DNS。

在浏览器中更改 DNS:

大多数新式浏览器(例如 Google Chrome 或 Firefox)都支持使用 DNS over HTTPS 直接在浏览器中修改正在使用的 DNS。有关修改您的浏览器使用的 DNS 的详细说明,请参阅此处。注意:您需要更改用作销售终端的每个浏览器上的 DNS。

Firefox:

blob

Chrome:

blob

请注意,Apple Safari 目前不支持 DNS over HTTPS,因此任何 DNS 更改都必须在设备本身上执行。

附加信息