将收银机与您的忠诚度计划连接起来

BonusQR 用手机扫码即可独立运行。如果您希望收银机也能处理会员业务,您的 POS 供应商可以通过我们有完整文档的 REST API 进行对接——收银机扫描顾客的二维码,一步完成折扣和奖励兑换。

  • 有完整文档的 REST API
  • 在收银机上应用折扣和奖励
  • 可选——没有它 BonusQR 也能运行
咖啡店里,收银员站在 POS 终端前,顾客出示会员二维码
POS现在

已扫描会员卡——已应用 10% 折扣

收银机读取会员二维码,并自行应用结果。

什么是 POS 会员集成?

POS 会员集成让您的收银机与忠诚度计划互通。员工无需在单独的应用中扫码,而是在收银机上扫描顾客的会员二维码,收银机就会应用计划给予的福利。

BonusQR 为此提供 REST API。收银机发送扫描到的二维码,必要时还会发送账单金额。BonusQR 会回复要执行的操作——应用百分比或金额折扣、兑换优惠券或积分奖励——并附上给员工的现成提示信息。

该集成是可选的,作为与您的 POS 供应商合作的定制项目进行。API 密钥由 BonusQR 发放,集成费用单独报价。

一次扫码,收银机能得到什么

POS 供应商对接您的收银机时所用的交互式 API 文档一览。

  1. 1

    识别顾客

    收银机扫描会员二维码,获取顾客的姓名、到店次数和各项余额。

  2. 2

    应用折扣

    百分比或金额折扣会作为操作返回,由收银机在账单上应用。

  3. 3

    兑换奖励

    优惠券、积分奖励以及用返现余额付款,都可以直接在收银机上完成。

  4. 4

    给员工的提示信息

    每次回复都附带使用您店铺语言的现成员工提示信息。

BonusQR APIOAS 3.0
POS在收银机上扫描顾客的二维码,获取收银机需要执行的操作。
GET/api/pos/config收银机的忠诚度计划设置
POST/api/pos/scan在收银机上扫码
Request body application/json
{ "code": "12345", "bill_amount": 12.50 }
Responses
200completedinput_requiredvoucher3failed
{
  "status": "completed",
  "kind": "customer",
  "customer": { 1
    "name": "张丽华",
    "visit_number": 12,
    "loyalty": { "credit": 13.55 }
  },
  "actions": [{ 2
    "type": "apply_percent_discount",
    "percent": 10,
    "reason": "会员俱乐部成员"
  }],
  "messages": [{ 4
    "level": "warning",
    "title": "折扣 10%",
    "lines": ["请从账单中扣除。"]
  }],
  "rewards_earned": []
}
POST/api/pos/scan/{scan_id}发送账单金额或商品数量
POST/api/pos/scan/{scan_id}/cancel取消待处理的扫码

您的 POS 供应商可使用交互式 API 文档和演示收银机来测试对接。

集成如何运作

连接收银机后,一笔购买是这样完成的。

顾客收银机BonusQR
  1. 顾客收银机出示会员二维码
  2. 收银机BonusQR发送扫描到的二维码POST /api/pos/scan
  3. BonusQR收银机必要时询问账单金额input_required
  4. 收银机BonusQR回复顾客应付的金额POST /api/pos/scan/{scan_id}
  5. BonusQR收银机返回折扣、奖励和员工提示信息completed
  6. 收银机应用折扣并完成销售
  7. BonusQR顾客在应用中查看印章、积分和奖励

集成的设计确保会员业务绝不会耽误付款:如果 BonusQR 没有响应,销售照常进行。

不做集成时,员工只需用手机或平板扫码——BonusQR 完全可以独立运行。

适用于所有忠诚度计划

API 能识别您优惠方案中的所有计划。例如:

在收银机上获得的奖励,会显示在顾客的应用中,供下次到店使用。

咖啡店现在

集章卡——收银机发送商品数量

美发店现在

固定折扣——按百分比从账单中扣除

餐厅现在

返现——余额以金额折扣的形式支付账单

面包店现在

奖励优惠券——付款时兑换

健身房现在

积分——在收银机上兑换奖励目录中的奖励

商店现在

消费满额奖励——账单金额计入下一张优惠券

POS 触摸屏和二维码扫码器正在读取顾客的会员二维码REST API

为真实的收银场景而设计

收银机在付款时扫码。如果 BonusQR 还需要更多信息,例如账单金额或商品数量,它会提出请求,由收银机回复。待处理的扫码可以取消,销售也永远不会被阻断。

  • 状态清晰:已完成、需要输入、失败
  • 待处理的扫码可以取消
  • 金额使用您店铺的货币
  • 每个密钥每分钟最多 60 次请求

POS 集成与 BonusQR 扫码器对比

两种方式都可行,选择适合您柜台的那一种。

POS 系统集成

设置
与 POS 供应商合作的定制项目
员工在哪里扫码
在收银机上
折扣
由收银机自动应用
价格
单独报价
vs

BonusQR 扫码器

设置
几分钟即可就绪
员工在哪里扫码
在手机、平板或柜台扫码器上
折扣
显示给员工,由员工应用
价格
所有套餐均包含

关于 POS 集成的问题

店主和 POS 供应商最常问的问题。

使用 BonusQR 必须做 POS 集成吗?

不必。BonusQR 完全可以独立运行——员工用手机、平板或柜台扫码器扫描顾客的二维码。集成是可选的。

可以连接哪些 POS 系统?

只要供应商能调用 REST API,任何系统都可以。BonusQR 没有针对特定收银机的现成插件,由您的供应商按照我们的文档进行对接。

集成需要多少费用?

这是一个定制项目,因此单独报价。联系我们,我们会与您的 POS 供应商一起准备报价。

怎样获得 API 密钥?

BonusQR 应要求发放。密钥可以限定只用于您店铺的某一个门店。

扫码后收银机会收到什么?

顾客的姓名、到店次数和各项余额,要应用的操作(百分比或金额折扣、优惠券或积分奖励),获得的奖励,以及给员工的现成提示信息。

如果收银机需要更多信息怎么办?

BonusQR 会提出请求,例如账单金额或商品数量,由收银机回复。待处理的扫码也可以取消。

有文档吗?

有。我们提供交互式 API 文档,以及可供供应商测试的演示收银机。

网店怎么办?

WooCommerce 和 Shopify 有现成的集成,需 Basic 套餐。

想在收银机上直接处理会员业务吗?

告诉我们您使用哪款 POS,我们会为集成准备报价。