Skip to main content
Skip table of contents

Encoded Commands

The following are a set of preformed commands according to the above specifications.

Command

VMC

Terminal

Reset

CCh 02h 3Ch 55h 5Fh

Result OK or Result NOK

Default reset

Sync

CCh 02h 3Ch 24h 2Eh

SYNC or Result NOK

Default sync

Protocol

CCh 07h 3Ch 13h 03h 00h 00h 00h 02h 27h

Protocol

Set protocol version 3 with DOL Authorization enabled

Setup

CCh 07h 3Ch 23h 00h 02h A3h 00h 00h D7h

Result OK or Result NOK

Setup for 48 hour session time, with commit on timeout.

Enable

CCh 02h 3Ch 12h 1Ch

Result OK or Result NOK

Default Enable

Disable

CCh 02h 3Ch 11h 1Bh

Result OK or Result NOK

Default Disable

Start Session

CCh 0Ah 3Ch 34h 00h 00h 09h C4h 00h 00h 00h 0Ah 1Dh

Card Read or Result NOK

Start session for 2500 cents with session ref 10 and default card data to return.

Cancel Session

CCh 02h 3Ch 37h 41h

Session Cancelled or Result NOK

Cancel Session

Auth Session

CCh 02h 3Ch 36h 40h

Session Approved, Session Declined or Result NOK

Auth session

Proprietary card, send ppse

CCh 16h 3Ch 38h 00h A4h 04h 00h 0Eh 32h 50h 41h 59h 2Eh 53h 59h 53h 2Eh 44h 44h 46h 30h 31h 00h B2h

RAPDU or Result NOK

Send ppse to proprietary card

Commit Session

CCh 0Ah 3Ch 35h 00h 00h 00h 04h 00h 00h 00h 6Ah B5h

Result OK or Result NOK

Commit session for 100 cents with session id 10.

Void Session

CCh 06h 3Ch 33h 00h 00h 00h 0Ah 4Bh

Result OK or Result NOK

Void session ref 10

Get Status

CCh 02h 3Ch 26h 30h

Status

Gets the status of the terminal

UI request

See paragraph UI request examples

Result OK or Result NOK

Request a screen to be displayed on the UI

The following are a set of preformed responses are sent by the terminal.

Response

Result OK

AAh 03h 3Ch 00h 00h E9h 

Result NOK

AAh 03h 3Ch 00h 01h EAh

Synchronized

AAh 02h 3Ch 24h 0Ch

Card Read

AAh xxh 3Ch 34h xxh DFh F0h 06h "(CARDHASH)" DFh CAh 0Bh "(masked PAN)" xxh

Example:

AAh 3Dh 3Ch 34h 3Ah DFh F0h 06h 28h 33h 30h 31h 32h 30h 34h 31h 30h 39h 32h 42h 45h 42h 41h 46h 32h 33h 41h 46h 43h 31h 44h 41h 31h 37h 35h 42h 31h 46h 33h 41h 35h 32h 39h 45h 36h 46h 32h 44h 31h DFh CAh 0Bh 0Ah 30h 31h 30h 30h 30h 30h 30h 30h 31h 38h 33h 

Card Read with Hash and masked PAN

Session Approved

AAh xxh 3Ch 31h "(User ref)" xxh DFh F0h 06h xxh "(CARDHASH)" DFh CAh 0Bh xxh "(masked PAN)" xxh

Example:

AAh 41h 3Ch 31h 00h 00h 00h 0Bh 3Ah DFh F0h 06h 28h 33h 30h 31h 32h 30h 34h 31h 30h 39h 32h 42h 45h 42h 41h 46h 32h 33h 41h 46h 43h 31h 44h 41h 31h 37h 35h 42h 31h 46h 33h 41h 35h 32h 39h 45h 36h 46h 32h 44h 31h DFh CAh 0Bh 0Ah 30h 31h 30h 30h 30h 30h 30h 30h 31h 38h 3Fh

Session approved with session id 11 and hash and masked PAN in response

Session Cancelled

AAh 02h 3Ch 33h 1Bh

Session Declined

AAh 02h 3Ch 32h 1Ah

Status

AAh 04h 3Ch 26h 01h 00h 11h

AAh 04h 3Ch 26h 10h 01h 21h

Status = Offline & No transaction runnning

Status = WAIT_CARD & Transaction runnning

*See more at Get Status section

Protocol

AAh 07h 3Ch 13h 03h 00h 00h 00h 02h 05h

Protocol version 3 with DOL Authorization enabled

UI Event

AAh 08h 3Ch 29h 73h 74h 61h 72h 74h 00h 45h

On the UI Start screen (see UI Request table), response when button "Start" is pressed.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.