Serial Connection Best Practice

Here is the quick debug steps that you might want use an serial connection from your Point of Sale machine or Vending Machine or PC.

1

Install Payment Apps

Option 1: Install Payment Apps, apps can be installed through ADB, or push by TMS.

https://ftp.wizarpos.com/payment/OPC_V1.7.0-global-release.apkftp.wizarpos.com

https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.0.0_2508081.apkftp.wizarpos.com

Option 2: Our tech support team also can help you to download these apk to your terminal.

2

Set Protocal Type to Serial or TMS Push Para to terminal

Option 1: Set terminal connection protocal type to Serial in Payment app, refer to PaymentInterfaceAppUserGuide.pdf

296KB

PaymentInterfaceAppUserGuide.pdf

PDF

Open

Option 2: Our tech support team also can help you to push parameter to your terminal to modify this settings.

3

Connect Payment Terminal to PC/Android Device/Point of Sale machine

With serial cable or usb cable that support serial protocal

4

Start serial port debug tool in your PC/Android Device/Point of Sale

Example:

5

Send handshake command data through by serial port tool

Here is sample request message.

HandShake

req:0202F10004620004313233340396

6

Send Transaction command data through by serial port tool

Here is some sample request message.

Transaction Request

req:02020100007B00A57B225472616E7354797065223A225075726368617365222C225472616E73416D6F756E74223A223132333435222C2243757272656E6379436F6465223A2230383432222C225265715472616E7344617465223A22313231313130222C225265715472616E7354696D65223A22313335343535222C22456E61626C6552656365697074223A747275652C22536B6970436F6E6669726D50726F636564757265223A747275657D03AB

PrintLast

req:02020100007B004C7B225472616E7354797065223A225072696E744C617374222C22456E61626C6552656365697074223A66616C73652C22536B6970436F6E6669726D50726F636564757265223A66616C73657D0351

Reversal

req:02020100007B00617B225472616E7354797065223A22526576657273616C222C224F72695472616E734964223A22313233343536222C22456E61626C6552656365697074223A66616C73652C22536B6970436F6E6669726D50726F636564757265223A66616C73657D031D

Refund

req:02020100007B00747B225472616E7354797065223A22526566756E64222C225472616E73416D6F756E74223A2231303030222C224F72695472616E734964223A22313233343536222C22456E61626C6552656365697074223A66616C73652C22536B6970436F6E6669726D50726F636564757265223A66616C73657D036F

Cancel Request

req:0202C1000001000003C1

For Serial / Socket Connection, you will need to follow

Payment App Integration Protocol

Here is some develop reference

Suitable for scenarios where no application development on the POS terminal is needed. Instead, the Vendor Machine communicates directly with the Payment App. In this case, communication between the POS terminal and the Vendor Machine supports serial port, MDB (Multi-Drop Bus), and Socket protocols.

Reference for data packaging and unpacking of VM：

https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zipftp.wizarpos.com

Here is an common quick debug video.