跳到主内容
版本: 2.x

Stripe Terminal 支付网关

Stripe Terminal 让您在收银台使用 Stripe 读卡器。收银台将金额发送到读卡器,顾客在读卡器上拍卡、插卡或刷卡。Stripe 完成扣款且没有剩余应付金额后,销售即完成。本页介绍如何完成一次性设置、为各收银台连接读卡器,以及收取第一笔款项。

已经设置好了?为此收银台连接读卡器或收款。

Pro 功能

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 中为每个店铺完成一次此设置即可。

  1. 安装扩展。 从 GitHub 的发布附件中下载插件压缩包 stripe-terminal-for-woocommerce.zip,依次选择 插件 > Add Plugin 和 上传插件,然后上传。GitHub 的“Source code”压缩包无法安装。
  2. 添加密钥。 前往 WP Admin > WooCommerce > 设置 > 支付,打开 Stripe Terminal,粘贴您的 正式密钥;如果想先试用,再填入 测试密钥。这两个密钥均来自 Stripe 管理平台。保存后,密钥会显示为圆点,并附有 (已保存;留空则保留) 提示。
  3. 为蓝牙读卡器和 Tap to Pay 选择 Terminal 地点。在 Stripe 管理平台的 Terminal → 地点 下,分别在测试模式和正式模式中创建一个地点,然后将其分别选为 Terminal 地点(测试) 和 Terminal 地点(正式)。
  4. 在 POS 连接 下 勾选此店铺允许使用的读卡器:智能读卡器、蓝牙读卡器和 Tap to Pay,或同时勾选两项。若要在应用中使用蓝牙读卡器或 Tap to Pay,请勾选 蓝牙读卡器和 Tap to Pay 并取消勾选 智能读卡器。请参阅智能读卡器、蓝牙读卡器或两者兼用。
  5. 保存设置,然后确认下方的 webhook 行显示 签名密钥已保存。
  6. 为 POS 启用此网关。 前往 WP Admin > POS > 设置 > 结账,开启 Stripe Terminal 并保存。无需在 WooCommerce 自身的付款方式列表中启用它;请参阅收银台设置。
首次连接前请选择 Terminal 地点

如果未选择地点,蓝牙读卡器或 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 中,点击侧边菜单底部的 设置,然后点击 读卡器。

收银台的设置页面已选中“读卡器”,所属店铺尚未设置任何读卡器
  1. 此店铺尚未设置任何读卡器 — 在支付网关中设置此收银台支持的读卡器类型之前,屏幕会显示此提示。设置后,这里会显示下文介绍的、此收银台可用的读卡器区域(浏览器或桌面收银台仅显示 智能读卡器)。

智能读卡器​

使用每台智能读卡器上显示的代码,在 Stripe 管理平台中注册读卡器。注册之前,它不会出现在 默认终端、已启用的终端 或收银台中。

智能读卡器 区域会为店铺允许使用的每台读卡器显示一行:读卡器名称旁边显示支付网关名称,下方显示 Terminal 地点,以及 在线 或 离线 状态。收银台使用标记为 已选择 的读卡器收款。若要切换,请点击另一台在线读卡器上的 使用此读卡器;此后结账时便会使用该设备收款。

系统会自动使用哪台读卡器?
  • 尚未选择:只要 默认终端 在线且空闲,收银台就会使用它。
  • 店铺中只有一台智能读卡器:无需选择。只要它在线且未被其他销售占用,收银台就会使用它收款。
  • 由店铺指定:启用 锁定终端选择 后使用 默认终端。只要它在线,就会在所有收银台上标记为 已选择,且所有读卡器行均不提供 使用此读卡器 选项。

蓝牙读卡器​

在 iOS 或 Android 应用中:

  1. 打开读卡器,并将其放在手机或平板电脑附近。
  2. 在 设置 → 读卡器 中,点击 连接读卡器。如果店铺有多个读卡器支付网关,系统会提示选择:在 连接读卡器所用的网关 下选择 Stripe Terminal。
  3. 该行会先显示 正在查找读卡器… 请打开读卡器,并将其放在此设备附近。,随后显示 找到 1 台读卡器。这是您的吗? 或 找到 3 台读卡器。哪台是您的? 点击您的读卡器旁边的 连接。
  4. 首次连接时会安装读卡器软件更新。 该行会显示 正在安装读卡器软件、进度条,以及 请保持读卡器开机且电量充足。首次更新约需 10 分钟。 开始前,请将读卡器电量充至一半以上,并停留在此页面。
  5. 该行会显示 已连接 及读卡器电量,例如 已连接 · 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。

测试完成后,请在真实收款前取消勾选 测试模式 并保存。

收款​

请先开启收银机

启用 开启和关闭收银机 后,收银机关闭期间,收银台不会记录付款,已收取的银行卡款项则需要退款。请参阅开启收银机。

  1. 将商品加入购物车,然后点击 结账。

  2. 点击收款面板上的 Stripe Terminal 选项卡片。

  3. 检查读卡器。智能读卡器会显示 终端:…;如果店铺允许切换,还会提供 更改 选项供您选择其他设备。蓝牙读卡器会显示 已连接 · 80%,或显示 未连接读卡器 及指向 设置 → 读卡器 的链接。

  4. 点击 将 … 发送到 Stripe Terminal,然后让顾客付款:

    • 智能读卡器:顾客在读卡器上拍卡、插卡或刷卡时,收银台会显示 正在等待顾客在终端上付款。
    • 蓝牙读卡器:收银台会显示 请在读卡器上使用银行卡。
    • Tap to Pay:手机会显示系统的 Tap to Pay 页面,顾客将银行卡或手机轻触您的手机即可。

    收银台会依次勾选 已发送、已到达终端、已批准 和 已扣款。

  5. 没有剩余应付金额后,收据页面会打开:打印收据或通过电子邮件发送收据,然后点击 新销售。请参阅确认付款完成。如果还有部分金额未付,请使用其他方式收取余款;请参阅拆分付款。

若要停止,请点击 在终端上取消。银行卡被拒绝时,会显示 付款失败:…,并提供 重试 和 选择其他方式 选项。请参阅使用读卡器。

此卡片无法手动输入银行卡信息。电话订单请参阅电话订单(MOTO)。

顾客在读卡器上添加的小费,会作为 小费 费用计入订单。WisePad 3、WisePOS E、S700 和 S710 支持提示顾客支付小费;M2 不支持。请在 Stripe 管理平台中为读卡器启用小费功能。

电话订单(MOTO)​

MOTO(邮购、电话订购)适用于客户不在现场的银行卡付款:您在读卡器屏幕上输入卡号、有效期和安全码,而不是让客户轻触银行卡。电话订单只能在结账的 旧版 选项卡中,通过 Stripe 自有付款面板处理。付款选项卡上的 Stripe Terminal 卡片不支持手动输入银行卡信息。

仅当以下三项条件全部满足时,才会显示 电话订单 开关:

  1. Stripe 已为您的账户启用 MOTO。 此功能默认关闭:请联系 Stripe 支持。
  2. 勾选电话订单(MOTO)。 前往 WP Admin > WooCommerce > 设置 > 支付 > Stripe Terminal,勾选 电话订单(MOTO) 并保存。
  3. 使用 S700、S710 或 WisePOS E 智能读卡器。 在 Stripe 面板中连接其中一款读卡器后,才会显示此开关。P400、M2、WisePad 3、Tap to Pay 或模拟读卡器均不会显示此开关。

勾选 电话订单(MOTO) 后,旧版选项卡中所有 Stripe Terminal 付款都会使用 Stripe 自有面板替代常规面板,并非只有电话订单才会使用。取消勾选后,旧版选项卡会显示 终端 选择器,以及 发送到终端、取消 和 重试 按钮;付款记录方式与收款面板相同。

接受电话订单的步骤:

结账的旧版选项卡,在支付网关付款页面中已选择 Stripe Terminal,下方开始显示可用读卡器列表,以及处理付款按钮
  1. 旧版 — 在收银台内显示店铺自身付款页面的选项卡。
  2. 店铺的付款页面 — 在此选择 Stripe Terminal,然后向下滚动到 可用读卡器、连接 和 电话订单。
  3. 处理付款 — 收银台位于页面下方的按钮,与其他旧版付款相同。电话订单需通过页面上的 使用终端付款 发起。
  1. 点击 结账,打开 旧版 选项卡并选择 Stripe Terminal。
  2. 在 可用读卡器 下,点击您的读卡器上的 连接。
  3. 开启 电话订单。
  4. 点击 使用终端付款。读卡器会显示银行卡信息输入页面,而不是提示拍卡。
  5. 在读卡器上输入卡号、有效期和安全码。
提示

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 支持处理账户问题。