【餐飲】WindCave使用說明 · 聚客搜索

### **【餐飲】WindCave使用說明** 備注：**支持版本21.9及以上收銀** ### **1.概述** #### **1.1.集成概述** WindCave 對接使用機型 IPP350 USB接口，集成接口使用ScrController (API XML Socket) 測試用卡AMERICAN EXPRESS/Diners Club/VISA/MASTER，集成測試在新西蘭進行，美國、新加坡等地未測試。完成測試功能-刷卡支付（Purchase）、退款（Refund）、分機支付。 #### **1.2.WindCave環境部署** ※注意：安裝驅動時，必須連接刷卡機 1.下載安裝SCR Controller Software，安裝時要連接好USB刷卡機。下載地址https://www.windcave.com/support-software下載Windcave Production Software (目前安裝文件名稱為PXTupeloInstaller_Scr2.exe，默認安裝目錄C:\Program Files (x86)\DPS\Eftpos_scr\) 注意：如果無法獲取刷卡機狀態，則需要替換pxscrcontroller_cfg.txt。備份原來的pxscrcontroller_cfg.txt，并使用新下載的覆蓋，然后重啟“Payment Express SCR 200 Controller” ![](https://img.kancloud.cn/eb/5c/eb5cfe3f782437fe9b2f343d4f7877fb_234x330.png) 2.使用dpseftxc.exe執行logon激活并測試是否正常連接（安裝目錄下，C:\Program Files (x86)\DPS\Eftpos_scr\） ![](https://img.kancloud.cn/91/d6/91d69ef106a55b68696d1ace2f79e751_393x403.png) 點擊Maint進入下級頁面 ![](https://img.kancloud.cn/4c/9f/4c9f637a029f8933c936fc2c2c2cb814_459x282.png) 點擊Logon 執行登錄操作，隨后顯示 ![](https://img.kancloud.cn/12/1e/121e57bf080b223df0d1ed8f092f494a_458x293.png) 表明登錄成功。 #### **1.3.驅動安裝過程截圖示意** 安裝過程一路Next即可。 ![](https://img.kancloud.cn/71/c3/71c35a409cbc8370065c46ffd23c1df0_429x250.png) ![](https://img.kancloud.cn/86/4e/864e790a8cdc2ba21d818828599b6796_451x329.png) ![](https://img.kancloud.cn/3a/73/3a736ab877be6f2602453f1cda0fa9f3_385x238.png) ![](https://img.kancloud.cn/a9/0e/a90e813608bb3bdee1f9364fc83ccacb_539x718.png) ![](https://img.kancloud.cn/dc/e2/dce2e06663c5d24d180357d22978b77e_564x712.png) ![](https://img.kancloud.cn/32/41/324133bc1211c2dc18b16d4e7098a497_376x258.png) ![](https://img.kancloud.cn/a4/19/a41980afc85d69dccfc762240a9250e3_720x938.png) ![](https://img.kancloud.cn/60/b8/60b809d88e63339d3af997f0dab684ca_711x825.png) ![](https://img.kancloud.cn/6b/5e/6b5e80f5f9aaa0b7b3a34fa68faad63b_719x465.png) #### **1.4.收銀21.6補丁程序的使用** 21.6版本收銀不支持windcave，所以需要替換補丁。替換方式為 1.重命名D:/COOLROID/Agile/POSClient.exe與POSManager.exe，以便備份 2.解壓補丁并把POSClient.exe/POSManager.exe拷貝到D:/COOLROID/Agile/目錄 3.進行一次下單、結賬操作，檢查有沒有問題 4.正常設置使用WindCave ### **2.收銀機使用** ### **2.1.后臺設置** 《支付方式》中《結賬類型》選擇“WindCave” ![](https://img.kancloud.cn/0b/4e/0b4e49b151b0baba5de330708cfb1a68_916x658.png) #### **2.2.前臺結賬** 結賬時，選擇WindCave，會自動調用windcave接口，刷卡成功后，會自動支付、打印、關臺。可以在已結單界面查看訂單信息。刷卡機默認超時時間為2min。 ![](https://img.kancloud.cn/ed/5d/ed5d3148e5c8fbdaf2549ec605afce13_1136x820.png) ![](https://img.kancloud.cn/e7/91/e791541d2223b3c1dbfb53b79f7103fc_1138x817.png) #### **2.3.找零CashOut** 當后臺勾選找零時，前臺可以選擇Purchase或者Purchase&Cashout，后者支持Cashout功能 ![](https://img.kancloud.cn/08/bf/08bf956a7119391a2eda82cf551499ac_910x640.png) ![](https://img.kancloud.cn/f7/ac/f7ac56891caad34e6dfe2114dc299278_910x669.png) ![](https://img.kancloud.cn/26/77/2677058db900be420fab0d8576cfc413_348x274.png) ![](https://img.kancloud.cn/3c/a5/3ca5f330179be1d2a63b709372a44f36_449x326.png) #### **2.4.小費** 刷卡機支付時，可以額外添加小費，當刷卡機添加好小費并刷卡成功后，收銀軟件可以獲取并添加小費金額到賬單中。 ![](https://img.kancloud.cn/9b/13/9b13565d399ec846abc76f259c177787_336x464.png) ![](https://img.kancloud.cn/01/da/01da006690de69fcc090e3f118549757_278x444.png) ![](https://img.kancloud.cn/91/90/9190575ee10063e4a468786273a4eba7_459x426.png) #### **2.5.ManPan** ManPan是不刷實體卡，而是直接在刷卡機上輸入卡號/CVC扣款 ![](https://img.kancloud.cn/d9/96/d996cb54aa543aae6471f05a189d8243_268x387.png) ![](https://img.kancloud.cn/b0/77/b077a8fc243fa1f41fce3042a349bf8e_221x384.png) ![](https://img.kancloud.cn/16/55/1655e0c7c67352fd368f32ac4b292ae8_192x358.png) ![](https://img.kancloud.cn/ce/80/ce805ff2f76900bc8eb94e640fbda05a_202x365.png) ![](https://img.kancloud.cn/ab/6a/ab6acfdbbf2855b8998e16b53f108203_210x355.png) #### ** 2.6.退款** 反結賬賬單之后，選中windcave支付，點擊退菜。刷授權卡后，即可退款。 ![](https://img.kancloud.cn/67/a7/67a7ada887ae65e1b0a0a143a27c8dc2_508x471.png) ![](https://img.kancloud.cn/5e/7b/5e7b67afbfa27bd579e4a92da809400d_509x426.png) ### **3.可能遇到的問題** #### **3.1.部署可能遇到的問題** **3.1.1.安裝服務時，需要連接刷卡機** **3.1.2.初次安裝后，連接刷卡機正常時，仍然無法獲取狀態或出現offline狀態** 有可能需要替換pxscrcontroller_cfg.txt并重啟服務 <?xml version="1.0" encoding="utf-8"?> <xml> <Server> <LogDrive>./</LogDrive> <LogLevel>1</LogLevel> <LogMaxFileSize>5120</LogMaxFileSize> <LogMaxTotalSize>51200</LogMaxTotalSize> <EnableSuppressTransmissionDisplay>0</EnableSuppressTransmissionDisplay> <TxnTimeoutSeconds>180</TxnTimeoutSeconds> <ScrRecoTextTableFileName/> <AlwaysPrintSignatureReceipt>0</AlwaysPrintSignatureReceipt> <AlwaysPrintSettlementReceipt>1</AlwaysPrintSettlementReceipt> <DisableEmptyXmlTagOutput>0</DisableEmptyXmlTagOutput> <EnableExtendedCardRead>0</EnableExtendedCardRead> <EnableDuplicateCashOutReceipt>0</EnableDuplicateCashOutReceipt> <EnablePxppCompatibleMessageMode>0</EnablePxppCompatibleMessageMode> <EnableReceiptFormatLines>1</EnableReceiptFormatLines> <ReceiptLineTerminator>0D0A</ReceiptLineTerminator> <EnableXifGUI>1</EnableXifGUI> <EnableBroadcastStatusOnNewClientConnection>0</EnableBroadcastStatusOnNewClientConnection> <EnableDummyValueForEmptyDpsTxnRef>0</EnableDummyValueForEmptyDpsTxnRef> <EnableTxnRefMatchingForGetLastTransaction>0</EnableTxnRefMatchingForGetLastTransaction> <EnableResetTxnMsgIdOnPosRestart>0</EnableResetTxnMsgIdOnPosRestart> <EnableMapBusyToInProgressForGetLastTransaction>0</EnableMapBusyToInProgressForGetLastTransaction> <DisableSerialPortIOCP>0</DisableSerialPortIOCP> <DefaultAccountType></DefaultAccountType> <EnablePxppCardTypeMapping>0</EnablePxppCardTypeMapping> <ReceiptHeader/> <ReceiptTrailer/> <EnableReceiptForAuth>0</EnableReceiptForAuth> <DisableOemData>0</DisableOemData> <EnableCompressedMerchantReceipt>0</EnableCompressedMerchantReceipt> <SuppressPosPromptsInPayAtTable>0</SuppressPosPromptsInPayAtTable> </Server> <HostInterfaces> <HostInterface> <Id>1</Id> <Name>SEC HTTPS</Name> <Type>HTTP</Type> <Address>https://sec.paymentexpress.com/scr.aspx</Address> <Port>443</Port> <Priority>1</Priority> <Enabled>0</Enabled> <Nii/> <IdleDisconnectTimeout>0</IdleDisconnectTimeout> <HeartbeatInterval>60</HeartbeatInterval> <EnableTcpKeepAlive>1</EnableTcpKeepAlive> <TcpKeepAliveTime>60</TcpKeepAliveTime> <TcpKeepAliveInterval>1</TcpKeepAliveInterval> <TcpKeepAliveCount>5</TcpKeepAliveCount> </HostInterface> <HostInterface> <Id>2</Id> <Name>SCR TCP</Name> <Type>TCP</Type> <Address>uat.paymentexpress.com</Address> <Port>65</Port> <Priority>1</Priority> <Enabled>1</Enabled> <Nii/> <IdleDisconnectTimeout>0</IdleDisconnectTimeout> <HeartbeatInterval>60</HeartbeatInterval> <EnableTcpKeepAlive>1</EnableTcpKeepAlive> <TcpKeepAliveTime>60</TcpKeepAliveTime> <TcpKeepAliveInterval>1</TcpKeepAliveInterval> <TcpKeepAliveCount>5</TcpKeepAliveCount> </HostInterface> </HostInterfaces> </xml> ![](https://img.kancloud.cn/9c/ff/9cff142fc41ddf45f90849c905c12f3f_1000x680.png) **3.1.3.安裝過程中出現錯誤** 點retry可以繼續 ![](https://img.kancloud.cn/43/72/437217196dfca7552cfb95fed8c1412e_474x291.png) **3.1.4.安裝中斷** 如果整個過程都已經能跑完，能夠檢測到pinpad，并且logon可以執行，則可以忽略該錯誤。否則的話，按照abort錯誤之前的步驟提示，去檢查問題所在。 ![](https://img.kancloud.cn/87/84/8784b1f910ea9d5e4eeec43395825752_463x265.png) **3.1.5.刷卡機不打印 merchant copy 和 customer copy** 刷卡機缺紙，或者刷卡機配置問題，請咨詢刷卡機售后 **3.1.6.Move5000無法安裝SCR Controller Software** 需要把Move5000切換為USB接口，然后使用USB轉串口連接線連接到收銀電腦 ![](https://img.kancloud.cn/62/3c/623c549c9e89160fc0d6391a5f54deda_643x941.png) ![](https://img.kancloud.cn/1b/67/1b679fc85d9a9abf7904b3b9d3467bf2_687x939.png) **3.1.7.不希望刷卡機打印merchant/customer copy** 從刷卡機上找配置 **3.1.8.每次刷卡后，都馬上返回Declined** 有可能是刷卡機沒有激活，請聯系windcave商務確認。其他檢查事項 1.卡片正常 2.刷卡機按鈕是否被錯誤按下 3.收銀機是否正確顯示錯誤信息（表示刷卡機與收銀機通信正常）