### **【餐饮】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”  2.使用dpseftxc.exe执行logon激活并测试是否正常连接（安装目录下，C:\Program Files (x86)\DPS\Eftpos_scr\）  点击Maint进入下级页面  点击Logon 执行登录操作，随后显示  表明登录成功。 #### **1.3.驱动安装过程截图示意** 安装过程一路Next即可。          #### **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”  #### **2.2.前台结账** 结账时，选择WindCave，会自动调用windcave接口，刷卡成功后，会自动支付、打印、关台。可以在已结单界面查看订单信息。 刷卡机默认超时时间为2min。   #### **2.3.找零CashOut** 当后台勾选找零时，前台可以选择Purchase或者Purchase&Cashout，后者支持Cashout功能     #### **2.4.小费** 刷卡机支付时，可以额外添加小费，当刷卡机添加好小费并刷卡成功后，收银软件可以获取并添加小费金额到账单中。    #### **2.5.ManPan** ManPan是不刷实体卡，而是直接在刷卡机上输入卡号/CVC扣款      #### ** 2.6.退款** 反结账账单之后，选中windcave支付，点击退菜。刷授权卡后，即可退款。   ### **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>  **3.1.3.安装过程中出现错误** 点retry可以继续  **3.1.4.安装中断** 如果整个过程都已经能跑完，能够检测到pinpad，并且logon可以执行，则可以忽略该错误。否则的话，按照abort错误之前的步骤提示，去检查问题所在。  **3.1.5.刷卡机不打印 merchant copy 和 customer copy** 刷卡机缺纸，或者刷卡机配置问题，请咨询刷卡机售后 **3.1.6.Move5000无法安装SCR Controller Software** 需要把Move5000切换为USB接口，然后使用USB转串口连接线连接到收银电脑   **3.1.7.不希望刷卡机打印merchant/customer copy** 从刷卡机上找配置 **3.1.8.每次刷卡后，都马上返回Declined** 有可能是刷卡机没有激活，请联系windcave商务确认。 其他检查事项 1.卡片正常 2.刷卡机按钮是否被错误按下 3.收银机是否正确显示错误信息（表示刷卡机与收银机通信正常）