API: https://openapidoc.mobile.cards/ vendor ID : fitsofttw secret key : KKPRYURR6532 測試環境 api endpoint: staging-api.mobilecardspro.com testing shop ID: 3f82c_fitsofttw testing 分店 ID 1: 19542 testing 分店 ID 2: 19543 測試會員網頁版介面 (你可以在這裡自行註冊會員,介面裡面已經有一些優惠可以測試): https://staging-shop.mobile.cards/fitsofttw 開發完成後,我們雙方會一起進行 UAT,我們也會有一個簡單的串接問卷需要你們填給我們,都處理完成後,我們會再另外提供正式環境的 Shop ID, API endpoint etc. API 1 Check Point 檢查點數 這個不一定是必須,但如果你們會可以在下單前,先輸入會員電話或掃會員 QR code,那透過這個 API,我們可以先回傳會員有的點數、等級、跟可用優惠給你們,按照可用優惠,你們可以讓店員進行手動換領 API 2 Update Point 更新點數 這個很常用,會使用在消費點數的情境,基本上照文件所述,把消費金額跟其他詳細資訊,連同會員資料給我們就好 API 21 Common Redeem Check 檢查優惠 這個也很常用,會使用在兌換優惠、使用點數的情境,照文件所述,掃瞄優惠 QR code 後傳給我們,我們回傳 QR code 是否有效,有效的話是對應哪一個 POS SKU。這個只作檢查,不作換領 API 13 Common Redeem 一般換領 這個也很常用,會使用在兌換優惠、使用點數的情境,照文件所述,掃瞄優惠 QR code 後,我們回傳 QR code 是否有效,有效的話是對應哪一個 POS SKU。這步完成立刻當作已換領 (扣除點數或一次性優惠) 有幾個情境基本上都會需要的 1 - 結帳累點 2 - 換領優惠 關於這個,可以直接用測試帳號裡面的去試,我有先放幾個不同的情境 - % 折扣、金額折扣、送品項,優惠所對應的優惠碼我們可以再約定 (e.g. 我們回傳什麼給你就代表是九折、是送品項、是折 $ etc.),目前我先隨便打了一些東西作示意,讓你們接收回傳時可以看到一些東西 3 - 按照等級自動給優惠 以 check point API 獲得會員等級的同時,如果該等級有對應折扣,我們也會帶一個優惠碼,目前我也先隨便放了一個 code,也開了一個金級會員 +886910717751 作為測試用 4 - 電子券 我設了一張電子券,你們也是一樣整個 QR code 放在 API 21 或 13 的 memberinput 作為參數就可以了,我也設好了測試券 RV-11A6GGEL8JSPQ2MYU9YM 其他情境其實你們也可以直接從 http://staging-shop.mobile.cards/fitsofttw 註冊登入,自己生成一張會員卡測試 金級會員測試電話:+886910717751 會員優惠 或 電子券的 QR code 連結是需要直接用作 memberinput 如果要獲得電子券,可以在後台發送 https://staging-office.openvrshop.com/ username: fitsofttwadmin pw: fitsoft15248!