應用市集
附加元件 v1.0.31

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 與該公司沒有任何關係。