Stripe Terminal 支付网关
Stripe Terminal 让您在收银台使用 Stripe 读卡器。收银台将金额发送到读卡器,顾客在读卡器上拍卡、插卡或刷卡。Stripe 完成扣款且没有剩余应付金额后,销售即完成。本页介绍如何完成一次性设置、为各收银台连接读卡器,以及收取第一笔款项。
已经设置好了?为此收银台连接读卡器或收款。
Stripe Terminal 需要 WCPOS Pro 2.0.0 或更新版本。没有它,此扩展将无法使用。
选择读卡器
Stripe 销售三类读卡器。收银台可以使用哪一类,取决于 POS 的运行平台。
- 智能读卡器 — 适用于所有收银台:浏览器、桌面应用、iPhone、iPad 和 Android。包括 Stripe Reader S700 和 S710、BBPOS WisePOS E。它连接到您的网络,由店铺向其发送收款请求。
- 蓝牙读卡器 — 仅适用于 iOS 和 Android 应用。包括 Stripe Reader M2、BBPOS WisePad 3。它与手机或平板电脑配对。
- Tap to Pay — 将在后续应用更新中加入 iOS 和 Android 应用。无需读卡器:顾客直接在手机上拍卡即可。
浏览器和桌面应用无法访问蓝牙读卡器或手机的非接触式芯片,因此这些收银台使用智能读卡器。您可以在 Stripe 管理平台的 Terminal 商店购买读卡器。
Stripe 在美国销售 Stripe Reader M2,在美国以外的英国、欧洲、加拿大、澳大利亚及其他国家和地区销售 BBPOS WisePad 3。请在 Terminal 商店查看您所在地区可购买的型号。
设置支付网关
管理员在 WP Admin 中为每个店铺完成一次此设置即可。
- 安装扩展。 从 GitHub 的发布附件中下载插件压缩包
stripe-terminal-for-woocommerce.zip,依次选择插件 > Add Plugin和 上传插件,然后上传。GitHub 的“Source code”压缩包无法安装。 - 添加密钥。 前往
WP Admin > WooCommerce > 设置 > 支付,打开 Stripe Terminal,粘贴您的 正式密钥;如果想先试用,再填入 测试密钥。这两个密钥均来自 Stripe 管理平台。保存后,密钥会显示为圆点,并附有 (已保存;留空则保留) 提示。 - 为蓝牙读卡器和 Tap to Pay 选择 Terminal 地点。在 Stripe 管理平台的 Terminal → 地点 下,分别在测试模式和正式模式中创建一个地点,然后将其分别选为 Terminal 地点(测试) 和 Terminal 地点(正式)。
- 在 POS 连接 下 勾选此店铺允许使用的读卡器:智能读卡器、蓝牙读卡器和 Tap to Pay,或同时勾选两项。若要在应用中使用蓝牙读卡器或 Tap to Pay,请勾选 蓝牙读卡器和 Tap to Pay 并取消勾选 智能读卡器。请参阅智能读卡器、蓝牙读卡器或两者兼用。
- 保存设置,然后确认下方的 webhook 行显示 签名密钥已保存。
- 为 POS 启用此网关。 前往
WP Admin > POS > 设置 > 结账,开启 Stripe Terminal 并保存。无需在 WooCommerce 自身的付款方式列表中启用它;请参阅收银台设置。
如果未选择地点,蓝牙读卡器或 Tap to Pay 将无法连接,收银台会显示 连接移动读卡器之前,请在 Stripe Terminal 设置中选择 Terminal 地点。
支付网关页面上的所有设置
- 标题 和 描述 — 顾客看到的名称和说明文字。收银台的选项卡片上会显示标题。
- 正式密钥 和 测试密钥 — 来自 Stripe 管理平台。
- 默认终端 — 收银台在选择其他读卡器之前用于收款的智能读卡器。
- 已启用的终端 — 将收银台可用的智能读卡器限制为您所选的设备。留空则允许使用账户中的所有读卡器。
- 锁定终端选择 — 收银员无法在 POS 结账时更改终端。 需要设置 默认终端。
- POS 连接 — 收银台可以使用的读卡器类型:智能读卡器(店铺通过网络控制读卡器) 和 蓝牙读卡器和 Tap to Pay(POS 应用控制读卡器)。请参阅智能读卡器、蓝牙读卡器或两者兼用。
- Terminal 地点(测试) 和 Terminal 地点(正式) — 应用连接蓝牙读卡器和 Tap to Pay 时,将其注册到的地点。
- 测试模式 — 启用测试模式。未使用 HTTPS 的网站会一直处于测试模式:Stripe Terminal 需要 HTTPS 才能进行真实收款。
- 电话订单(MOTO) — 通过 Stripe Terminal 启用电话订单付款。请参阅电话订单(MOTO)。
- 读卡器保活(实验性) — 定期向读卡器发送探测请求,避免闲置一段时间后的首笔收款速度变慢。多个收银机共用一台读卡器时,不建议启用。
在这些字段下方,页面会列出您的 Stripe Terminal 地点 和 webhook 行。
智能读卡器、蓝牙读卡器或两者兼用
POS 连接 是店铺级别的设置,决定所有收银台使用哪类读卡器。
- 仅勾选 智能读卡器:所有收银台均使用智能读卡器收款。
- 仅勾选 蓝牙读卡器和 Tap to Pay:iOS 和 Android 应用使用蓝牙读卡器或手机收款。在浏览器或桌面收银台上,Stripe 选项卡片会折叠到 … 暂时不可用 下方,并显示提示:此付款方式仅允许使用应用中的读卡器。若要从此收银台收款,请在其 WooCommerce 设置页面上允许使用智能读卡器。
- 两者都选:收银台使用智能读卡器。 只有取消勾选 智能读卡器 后,才能使用蓝牙读卡器和 Tap to Pay。
更改读卡器类型或升级
取消勾选某一类型,只会改变收银台接下来使用哪种设备收款。每笔付款仍通过原收款连接退款,无论原来使用的是智能读卡器还是应用,Stripe 的 webhook 也会继续工作。从旧版本升级时,会保留已保存的连接;如果只保存了 默认终端,则保留智能读卡器连接。全新安装时默认勾选两项,因此应用会一直使用智能读卡器,直到您取消勾选 智能读卡器。
为此收银台连接读卡器
每个收银台都会记住自己的读卡器。在 POS 中,点击侧边菜单底部的 设置,然后点击 读卡器。

- 此店铺尚未设置任何读卡器 — 在支付网关中设置此收银台支持的读卡器类型之前,屏幕会显示此提示。设置后,这里会显示下文介绍的、此收银台可用的读卡器区域(浏览器或桌面收银台仅显示 智能读卡器)。
智能读卡器
使用每台智能读卡器上显示的代码,在 Stripe 管理平台中注册读卡器。注册之前,它不会出现在 默认终端、已启用的终端 或收银台中。
智能读卡器 区域会为店铺允许使用的每台读卡器显示一行:读卡器名称旁边显示支付网关名称,下方显示 Terminal 地点,以及 在线 或 离线 状态。收银台使用标记为 已选择 的读卡器收款。若要切换,请点击另一台在线读卡器上的 使用此读卡器;此后结账时便会使用该设备收款。
系统会自动使用哪台读卡器?
- 尚未选择:只要 默认终端 在线且空闲,收银台就会使用它。
- 店铺中只有一台智能读卡器:无需选择。只要它在线且未被其他销售占用,收银台就会使用它收款。
- 由店铺指定:启用 锁定终端选择 后使用 默认终端。只要它在线,就会在所有收银台上标记为 已选择,且所有读卡器行均不提供 使用此读卡器 选项。
蓝牙读卡器
在 iOS 或 Android 应用中:
- 打开读卡器,并将其放在手机或平板电脑附近。
- 在 设置 → 读卡器 中,点击 连接读卡器。如果店铺有多个读卡器支付网关,系统会提示选择:在 连接读卡器所用的网关 下选择 Stripe Terminal。
- 该行会先显示 正在查找读卡器… 请打开读卡器,并将其放在此设备附近。,随后显示 找到 1 台读卡器。这是您的吗? 或 找到 3 台读卡器。哪台是您的? 点击您的读卡器旁边的 连接。
- 首次连接时会安装读卡器软件更新。 该行会显示 正在安装读卡器软件、进度条,以及 请保持读卡器开机且电量充足。首次更新约需 10 分钟。 开始前,请将读卡器电量充至一半以上,并停留在此页面。
- 该行会显示 已连接 及读卡器电量,例如 已连接 · 80%。
后续连接只需几秒,收银台会在下一笔销售时重新连接同一台读卡器。未连接读卡器时,蓝牙读卡器 区域会显示 尚未连接读卡器。请打开读卡器,并将其放在此手机附近。
Tap to Pay
Tap to Pay 将在后续应用更新中加入 iOS 和 Android 应用;以下介绍应用具备此功能后的使用方式。 在装有 iOS 或 Android 应用的手机上,此手机 区域会显示 iPhone 上的 Tap to Pay 或 Android 上的 Tap to Pay。店铺经理或管理员点击 设置 Tap to Pay 即可。其他人会看到 尚未设置 · 请联系管理员。
首次设置时,手机会要求您接受服务提供商的条款:在 iPhone 上,Apple 会要求关联 Apple ID 并接受其 Tap to Pay 条款。设置完成后,该行会显示 就绪。Tap to Pay 需要联网才能收款。
读卡器行可能显示的状态
每个读卡器行会显示读卡器名称、序列号、Terminal 地点以及一行状态:
- 已连接 · 80% — 已准备好收款,并显示剩余电量。Tap to Pay 则显示 就绪。
- 未连接 — 收银台已记住此读卡器,但目前未连接。请点击 连接。
- 正在连接到 … — 请稍候。按钮显示 正在连接…。
- 正在安装读卡器软件 — 正在更新;请参阅蓝牙读卡器的第 4 步。
- 未找到读卡器。请打开读卡器并重试。 — 点击 重试,或点击 找不到您的读卡器? 查看读卡器指南。
- 无法连接:… — 后面会显示 Stripe 提供的原因。请点击 重试 或 帮助。
- 请打开蓝牙以连接读卡器。 — 此设备的蓝牙已关闭。
- 请在应用设置中允许访问读卡器。 — 应用尚未获得使用蓝牙的权限。请在手机设置中授予权限。
读卡器行旁边的 ⋮ 菜单中有 忘记 选项:选择后,收银台不会在下一笔销售时重新连接该读卡器。您可以在此页面重新连接。已连接行上的 断开连接 按钮会暂时断开与读卡器的连接。如果读卡器一直被应用占用,菜单还会提供 释放读卡器 选项。
正式使用前先测试
在支付网关的设置页面(WP Admin > WooCommerce > 设置 > 支付 > Stripe Terminal)勾选 测试模式 并保存。此后付款会进入 Stripe 的测试账户,不会发生真实资金转移。按收款中的步骤进行一次测试销售。
- 智能读卡器:在 Stripe 测试账户中注册的模拟读卡器会与真实读卡器一同列出,因此无需硬件也能进行销售测试。
- 蓝牙读卡器 和真实的智能读卡器:使用 Stripe 实体测试卡付款,可从 Stripe 管理平台的 Terminal 商店订购。金额的最后两位数字决定付款结果:
.00表示批准,.05表示拒绝,.02则要求输入 PIN 码1234。
测试完成后,请在真实收款前取消勾选 测试模式 并保存。
收款
启用 开启和关闭收银机 后,收银机关闭期间,收银台不会记录付款,已收取的银行卡款项则需要退款。请参阅开启收银机。
-
将商品加入购物车,然后点击 结账。
-
点击收款面板上的 Stripe Terminal 选项卡片。
-
检查读卡器。智能读卡器会显示 终端:…;如果店铺允许切换,还会提供 更改 选项供您选择其他设备。蓝牙读卡器会显示 已连接 · 80%,或显示 未连接读卡器 及指向 设置 → 读卡器 的链接。
-
点击 将 … 发送到 Stripe Terminal,然后让顾客付款:
- 智能读卡器:顾客在读卡器上拍卡、插卡或刷卡时,收银台会显示 正在等待顾客在终端上付款。
- 蓝牙读卡器:收银台会显示 请在读卡器上使用银行卡。
- Tap to Pay:手机会显示系统的 Tap to Pay 页面,顾客将银行卡或手机轻触您的手机即可。
收银台会依次勾选 已发送、已到达终端、已批准 和 已扣款。
-
没有剩余应付金额后,收据页面会打开:打印收据或通过电子邮件发送收据,然后点击 新销售。请参阅确认付款完成。如果还有部分金额未付,请使用其他方式收取余款;请参阅拆分付款。
若要停止,请点击 在终端上取消。银行卡被拒绝时,会显示 付款失败:…,并提供 重试 和 选择其他方式 选项。请参阅使用读卡器。
此卡片无法手动输入银行卡信息。电话订单请参阅电话订单(MOTO)。
顾客在读卡器上添加的小费,会作为 小费 费用计入订单。WisePad 3、WisePOS E、S700 和 S710 支持提示顾客支付小费;M2 不支持。请在 Stripe 管理平台中为读卡器启用小费功能。
电话订单(MOTO)
MOTO(邮购、电话订购)适用于客户不在现场的银行卡付款:您在读卡器屏幕上输入卡号、有效期和安全码,而不是让客户轻触银行卡。电话订单只能在结账的 旧版 选项卡中,通过 Stripe 自有付款面板处理。付款选项卡上的 Stripe Terminal 卡片不支持手动输入银行卡信息。
仅当以下三项条件全部满足时,才会显示 电话订单 开关:
- Stripe 已为您的账户启用 MOTO。 此功能默认关闭:请联系 Stripe 支持。
- 勾选电话订单(MOTO)。 前往
WP Admin > WooCommerce > 设置 > 支付 > Stripe Terminal,勾选 电话订单(MOTO) 并保存。 - 使用 S700、S710 或 WisePOS E 智能读卡器。 在 Stripe 面板中连接其中一款读卡器后,才会显示此开关。P400、M2、WisePad 3、Tap to Pay 或模拟读卡器均不会显示此开关。
勾选 电话订单(MOTO) 后,旧版选项卡中所有 Stripe Terminal 付款都会使用 Stripe 自有面板替代常规面板,并非只有电话订单才会使用。取消勾选后,旧版选项卡会显示 终端 选择器,以及 发送到终端、取消 和 重试 按钮;付款记录方式与收款面板相同。
接受电话订单的步骤:

- 旧版 — 在收银台内显示店铺自身付款页面的选项卡。
- 店铺的付款页面 — 在此选择 Stripe Terminal,然后向下滚动到 可用读卡器、连接 和 电话订单。
- 处理付款 — 收银台位于页面下方的按钮,与其他旧版付款相同。电话订单需通过页面上的 使用终端付款 发起。
- 点击 结账,打开 旧版 选项卡并选择 Stripe Terminal。
- 在 可用读卡器 下,点击您的读卡器上的 连接。
- 开启 电话订单。
- 点击 使用终端付款。读卡器会显示银行卡信息输入页面,而不是提示拍卡。
- 在读卡器上输入卡号、有效期和安全码。
Stripe 将电话订单视为无卡交易,因此不适用线下银行卡交易费率及其欺诈责任转移机制。
遇到问题时
读卡器无法连接。 智能读卡器必须连接 Wi-Fi 或以太网,且已在 Stripe 管理平台中注册并显示为在线。蓝牙读卡器需要使用 iOS 或 Android 应用,设备已打开蓝牙,且已允许应用使用蓝牙。
“选择 Terminal 地点…”。 支付网关尚未为当前模式(测试或正式)设置 Terminal 地点。请参阅设置支付网关的第 3 步。
首次连接耗时很长。 这是读卡器正在更新软件,约需 10 分钟。请保持读卡器开机且电量充足,并停留在此页面。下次连接只需几秒。
Stripe 选项卡片显示不可用。 在浏览器或桌面收银台上,这是因为店铺仅允许使用应用中的读卡器。请参阅智能读卡器、蓝牙读卡器或两者兼用。离线时,读卡器需要等待网络恢复;请参阅离线模式。
读卡器页面显示 此店铺仅允许使用应用中的读卡器。 在浏览器或桌面收银台上,原因同上:请在 POS 连接 下允许使用 智能读卡器,或改用 iOS 或 Android 应用。请参阅智能读卡器、蓝牙读卡器或两者兼用。
银行卡被拒绝。 请顾客换一张银行卡或改用其他付款方式。在测试模式下,请检查金额的最后两位数字。
没有电话订单开关。 电话订单只能在 旧版 选项卡中处理,不能通过 Stripe Terminal 卡片处理。请检查是否已勾选 电话订单(MOTO)、是否已连接 S700、S710 或 WisePOS E,以及所连接的是否为真实读卡器而非模拟读卡器。
电话订单失败。 Stripe 尚未为您的账户启用 MOTO,或输入的银行卡信息有误。
仍未解决? 请在 GitHub 上报告问题,查阅 Stripe 的 Terminal 文档了解读卡器相关信息,或联系 Stripe 支持处理账户问题。