Pre-requisites
1) Install al-ecr-integration with Logos branch.
2) Pls start nodeJS server on vm95, node-integration-pax project (branch dev_QF). (run command: npm start)
Click the link to check the server is available or not, successful when the website loaded. Bizspoke API Server Status
In new sandbox:
3) In "POS Hardware Profile Card", create a new H/W profile or modify existing profile.
enter the following fields:
| Role | Sub Role | ID | Hardware Station Host | IP Address | Port Number | Terminal ID | Store ID | Remark | Terminal IP | Terminal Port | Terminal Timeout (ms) | QF POS Key | QF POS IV |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| EFT1 | localhost:8082 | 103.253.10.170 | 3000 | 242KCASB9814 | 1000031263 | 10.168.0.165 | 9001 | 60000 | ●●●●●●●●●● | qfpay202306_hjsh |
*** DO NOT change the red text value, "ID", "Terminal Port", "QF POS IV"
^1) "IP Address" is the public IP
^2) "Port Number" is the exposed port at firewall
^3) "Terminal ID", "Store ID" refers to the PDF at "\\10.168.0.133\Project_shared\NAV\Logos\QF_Pay\商户帳號設置表格 - Bizspoke Technology Company Limited (Testing).pdf".
^4) "Terminal IP" = QF Pay Terminal IP, you may find it in the device Wi-Fi setting
^5) "QF POS IV" = qfpay202306_hjsh
Defined in https://sdk.qfapi.com/docs/in-store/pos-api/ECR/#1-pos-key
^6) "QF POS Key" can be found from QF Management Portal https://sh-hk.qfapi.com/#/
^7) "Terminal Timeout (ms)", at least 30000ms (equivalent to 30sec)
4) Create a new package in "Configuration Package" with the 5 tables ID in below screenshot.
Then click "Import from Excel" on top action bar. Import the file ECRSetupQF.confpack.xlsx.
* Pls make sure the retail user (the account logged-in, i.e. BIZSUPPORT) with [Store No.] = MK. If not, you may need to create store tender types for another store manually on BC. (Or you can change it directly in the attached excel file, Sheet "Tender Type" > column "Store No.")
5) Run POS in the new sandbox, you need to remap the payment buttons to allow POS send payment request to the card terminal
6) Test to start a payment on POS. Expected the card terminal can jumps to payment request screen, and able to complete the transaction.