Card readers
概述
连接到 Square。收银台把金额发到你柜台上的 Square Terminal。顾客挥卡或插卡,还可以加小费。员工能看到收了多少,小费单独列出,还有卡的品牌和后四位数字。一次结账不是以已收款结束,就是以已取消结束,并附上 Square 给出的原因。你的店铺是卖方:Square 账户、访问令牌和钱都是你的,Adminium 不是任何一笔付款的当事方。卡由 Terminal 读取并发往 Square,所以没有任何卡号会到达你的服务器。在 Adminium 中发起的退款会经由 Square 原路退回。Interac 付款(加拿大)只能在 Terminal 上退款,所以 Adminium 会拒绝。在 Square Dashboard 里做的退款和争议,Adminium 也会读取。它在 Studio → 付款 中设置,用你自己 Square 账户的访问令牌:测试付款用沙盒令牌,正式付款用生产令牌。每台读卡器在 付款 → Card readers 中配对,配对用的设备码要在 Terminal 上输入。Adminium 从服务器向读卡器发起询问,所以没有公网地址的服务器也能用。Square 会把 Terminal 上的一次结账保留 30 天,Adminium 则自己留一份收款记录。Square 在德国不提供;在德国请通过 Card payments 改用 Stripe 读卡器。它没有自己的界面,也没有自己的表,可配合所有应用使用。它需要 Adminium 0.3.60 或更高版本。
它依附在什么上
这一个不绑定某个应用。它在 Adminium 本身中工作,也在任何承载附加组件的应用中工作。
连接后它可以做什么
它需要你自己 Square 账户里的一个访问令牌:测试付款用沙盒令牌,正式付款用生产令牌。两者都加密保存在你的服务器上,附加组件的任何部分都不会到达浏览器。这个令牌能打开整个 Square 账户,因为 Square 没有更窄的令牌可给你自己的应用;请只把它放在 Studio 里,别处都不要放,万一泄露,就在 Square Developer Console 里另建一个。它不带来任何自己的表。它的服务器部分只能调用下面两个地址,一个用于测试,一个用于正式,别无其他。
它的服务端代码可以访问的地址
- connect.squareupsandbox.com
- connect.squareup.com
这份清单就是全部:访问其他地址会被拒绝并记录下来。
连接时需要什么
一个 API 密钥
它增加了什么
它出现在哪里 4
- 在 Adminium 中:它在 Studio → 付款 下的卡片,在这里粘贴沙盒或生产环境的访问令牌,“检查”会告诉你这是谁的 Square 账户
- 在 Adminium 中:付款 → Card readers,“配对读卡器”给读卡器起个名字,并显示一个要在 Square Terminal 上输入的设备码
- 在收银台:金额发到 Square Terminal,顾客挥卡或插卡,还可以加小费,收银台显示收了多少,小费单独列出,并带有卡的品牌和后四位数字;一次结账不是以已收款结束,就是以已取消结束,并附上 Square 给出的原因
- 退款:在 Adminium 中发起的退款经由 Square 原路退回,Interac 付款(加拿大)除外,它只能在 Terminal 上退款;在 Square Dashboard 里做的退款和争议会显示在 付款 → 活动 中
它带来的数据表 0
没有 —— 它不带自己的数据表。
需要配置的设置 1
- 访问令牌
如果你把它关掉
断开连接会移除附加组件的界面。它绝不会删掉自己创建的数据表、写入的文件或添加的记录 —— 它写下的一切都留在你的数据库里。 交给它的凭据会随之被吊销并删除。
会留下什么
每一笔已收的付款都仍记录在它的记录上,小费单独列出,并保留卡的品牌和后四位数字。Adminium 自己留有一份,所以在 Square 保留 Terminal 结账的 30 天过后,付款仍能完整查看。它没有带来任何自己的表。你的 Square 账户和账户里的钱都不受影响。
会消失什么
Card readers 会从 Studio → 付款 中消失,收银台不能再把金额发到 Terminal。在 Square Dashboard 里做的退款和争议不再被读取。Square 无法从外部取消 Terminal 配对,所以请在设备本身上退出每台 Terminal 的登录。
关于演示
本站的任何演示都不会真的调用别人的服务。每个附加组件都自带一个替代传输层,回答来自内置数据,并且默认就是开着的。真正的凭据属于自托管的选择,写在该附加组件自己的 README 里。
如何打开它 本网站上的演示都不包含它。在你自己的 Adminium(0.3.60 或更高版本)里,在“附加组件”中安装 Card readers,打开 Studio → 付款,用你自己 Square 账户的沙盒访问令牌连接它,先做测试付款,再改用生产令牌。读卡器在 付款 → Card readers 中配对。
Adminium 与该公司没有关联。