document

GENERIC ECR/POS INTEGRATION SPECIFICATION

Document Number: KH-ECR-TERM-MSG-SPEC-001

Softcopy Name: Generic ECR Integration Spec_v1.3

Release: 1.3

Published Date: May 29, 2012

Document Classification:

Prepared By: Rommy Susiangto

Last Updated By: Rommy Susiangto

COPYRIGHT NOTICE

Copyright (2012) by KORVAC HOLDINGS PTE LTD

All rights reserved. This material is confidential and proprietary to KORVAC HOLDINGS PTE LTD

and no part of this material should be reproduced, published in any form by any means,

electronic or mechanical including photocopy or any information storage or retrieval system

nor should the material be disclosed to third parties without the express written authorisation

of CARD ALLIANCE PTE LTD/KORVAC HOLDINGS PTE LTD

GENERIC ECR INTEGRATION SPECIFICATION VERSION: 1.2

Interface request and response message format DATE: 29/5/2012

Confidential Payment Link Pte. Ltd. Page 2 of 64

DOCUMENT HISTORY

Date Version Description Author

14/5/2012 1.0 1st

Release – Previous release based on

Smartec v4.9

Rommy Susiangto

21/5/2012 1.1 Revised Section 3 – Physical Interface,

for DB9 connector, and connectivity

requirement for RS232 asynchronous

protocol.

Added Section 9.26 - Mobile Airtime

Transfer function (F6).

Revised Section 7.2 Field type “H6” to

represent binary flag, field type “T2”

to include Topup sent amount for

Mobile Airtime Transfer, and included

the last section on Mobile Airtime

Transfer

Added Section 9.26 for Mobile Airtime

Transfer.

Added Appendix B : ISO4217 Currency

code.

Added Appendix C : International

Telcom Country Code

Rommy Susiangto

24/05/2012 1.2 Removed TransactionID from the

response to the POS.

Rommy Susiangto

29/05/2012 1.3 Remarks of Field 40 for Epins Cashout

& HSBC QuickCash function 22 has

been changed

Rommy Susiangto




REFERENCED DOCUMENTS

Document Name Document Number Version No

Smartec ECR Integration

Spec_v5.0

5.0




TABLE OF CONTENTS

1. INTRODUCTION ....................................................................................................... 6

2. TERMS USED IN THE DOCUMENT ............................................................................... 7

3. PHYSICAL INTERFACE................................................................................................ 8

4. PROTOCOL .............................................................................................................. 9

4.1. Control Characters ................................................................................................... 9

4.2. Normal request and response ................................................................................... 9

4.3. Communication error ..............................................................................................10

5. Message Structure ..................................................................................................12

5.1. Transport Header....................................................................................................12

5.2. Presentation Header ...............................................................................................13

5.3. Field Data ..............................................................................................................14

5.3.1. Field Element Format ........................................................................................15

5.3.2. Extra Field Separators .......................................................................................16

6. TRANSACTION CODES ..............................................................................................17

7. FIELD TYPES............................................................................................................20

7.1. Field Attributes ......................................................................................................20

7.2. Field Type Definitions..............................................................................................20

8. Transactions supported ...........................................................................................27

8.1. Purchase / Sale+Cash (Transaction code 20) ..............................................................27

8.2. EPINS Cashout & HSBC QuickCash (Transaction code 22).............................................29

8.3. Void (Transaction code 26) ......................................................................................31

8.4. Refund – Credit (Transaction code 27)......................................................................32

8.5. Tip Adjust (Transaction code 28) ..............................................................................33

8.6. Ticket Inquiry (Transaction code 37) .........................................................................34

8.7. Bonus Sales (Transaction code 93) ............................................................................35

8.8. EPP Sales (Transaction code 94) ...............................................................................36

8.9. Logon (Transaction code E0)....................................................................................37

8.10. EZLink Top-up (Transaction code E1)..................................................................38

8.11. EZLink Debit (Transaction code E2) .....................................................................40

8.12. EZLink Confirm Trans (Transaction code E3) ........................................................42

8.13. EZLink Settlement / Reset (Transaction code E4)..................................................43

8.14. EZLink GetLastSettle (Transaction code E5) .........................................................44

8.15. EZLink GetLastTrans (Transaction code E6) ..........................................................45

8.16. EZLink GetCSCDetail (Transaction code E7)..........................................................46




8.17. EZLink GetCSCDetailExt (Transaction code E8) .....................................................47

8.18. Non-Cash EZLink Top-up (Transaction code E9) ....................................................48

8.19. EPINS Payment (Transaction code EA).................................................................49

8.20. Enquiry (Transaction code F0) ............................................................................50

8.21. Redemption & Award (Transaction code F1) ........................................................51

8.22. Void Redemption & Award (Transaction code F2) ................................................53

8.23. Refund Redemption & Award (Transaction code F3).............................................54

8.24. EPINS Purchase with Cash Back (Transaction code F4) ..........................................56

8.25. EPINS Bill Payment (Transaction code F5) ...........................................................57

8.26. Mobile Airtime Transfer (Transaction code F6) ....................................................58

Appendix A: Sample Data of Transactions.........................................................................59

Appendix B: IS04217 CURRENCY CODE .............................................................................60

Appendix C: INTERNATIONAL TELCOM COUNTRY CODE ......................................................61




1. INTRODUCTION

This document describes the interface and message specification that allows a Point-Of-Sale (POS)

device to connect to an intelligent POS communications and application controller - called the

Terminal. The terminal enables the POS device to easily support a wide range of credit card functions,

including authorizations and data capture.

The Terminal effectively isolates the POS device (ECR, PC, etc.) from the complexities of the credit

and debit card transaction communications environment. It acts as a powerful communications

device, and more importantly, it relieves the POS device from demanding tasks of network and

financial message interchange compliance.

This interface is designed to be simple, yet flexible. It is a compromise interface intended to provide

a wide range of functions at minimal complexity.

Some of the implementation details may appear to be too complex when viewed from the

perspective of a single implementation. Wherever possible this document will try to explain the

reasons behind these details, and how they will be used.

This document should be used in conjunction with an implementation guide that describes the

details of the particular implementation that you are developing the interface for.

It is not possible to maintain a single implementation specification that will be suitable for all

implementations.

This document serves as a central reference point so that the different implementations will at least

be compatible with each other at a protocol and message structure level.




2. TERMS USED IN THE DOCUMENT

The following table lists the terms that are used in this document that are not necessarily obvious.

TERM DESCRIPTION

POS Point Of Sale Device.

In this document this term will be used to indicate any one or more of the

following:

- an ECR

- an ECR controller that is connected to a number of ECR's

- a standalone PC- a workstation or minicomputer

- a mainframe host

Terminal Equipment that connects to the POS using the message specifications in

this document.

The Terminal will also be responsible for communicating with the

appropriate host system using whatever link, protocol and message

formats required.

Constant

Declarations

The following types of constant values are used in this document:

Character/String values are shown in single quote characters. For example,

the letter A will be shown as 'A'. The text string Hello World will be shown

as 'Hello World'. Each character in this type of declaration occupies one

byte of storage.

Hexadecimal values are shown with a lower case h suffix. For example, a

value of 40 hexadecimal is shown as 40h. (This is 64 decimal, 100 octal, and

01000000 binary).

Each 2 digit hexadecimal value occupies one byte of storage.

REQD Required in the message.

OPTL May be in the message. The comment area will often explain the

conditions that will cause it to be included.

APPR Included if the transaction is approved.

NVRAM Non-Volatile RAM

This is battery-backed memory in the Terminal that is used to store

configuration data.




3. PHYSICAL INTERFACE

The Physical Interface used between the POS and the Terminal is detailed in the following table.

Data Rate 9600 bps

Connection

DB9 can be a male / female connector or up to the P.C port configuration.

To Ingenico Telium terminal, the connector must be an RJ11 6-pins

connector. Please take note that only the pins configuration illustrated

below need tobe soldered. The rest of the pins are not necessary.

Transmission Asynchronous, 8 data bits, no parity, 1 stop bit (N,8,1)

Characters ASCII character set (for character fields)

The RS232 pin connections are specified in the following table.

RJ11 DB9

Connector

PIN TERMINAL PIN POS

5 TX 2 RX

4 RX 3 TX

1 GND

5 GND




4. PROTOCOL

Fortunately the RS232 connection between the POS and the Terminal is almost completely free of

errors; therefore a simple protocol can do the job well.

In order to prevent a single error on the line from causing a message to be lost, a message will be

acknowledged when the receiver returns an ACK character.

Only a single unacknowledged message can be outstanding at one time in one direction. The receipt

of a message does not imply the previous message sent has been received.

4.1. Control Characters The following five control characters are used to control the communication protocol. All the

proposed values are in hexadecimal format.

Start of Text STX 0x02

End of Text ETX 0x03

Acknowledgement ACK 0x06

Negative Acknowledgement NAK 0x15

4.2. Normal request and response

Request Message POS

STX Length of Message Message Data bytes… ETX LRC ��

Terminal

ACK

Response Message

STX Length of Message Message Data bytes… ETX LRC

ACK ��




4.3. Communication error

Case 1: No Acknowledgement from terminal or POS within 5 seconds

(The example below illustrates when there’s no ACK sent by the terminal, but it’s the same

process for when the POS does not respond with an ACK)

Request Message POS


Terminal

No ACK sent within 5 second from Terminal

Resend Request Message


No ACK sent within 5 second from Terminal

Resend Request Message


POS records Message Undeliverable Status

Case 2 – Incorrect message Response or Request

Request Message POS


Terminal

ACK

Response Message

Incorrect Message Response (i.e. Missing ETX or incorrect LRC or invalid

length.)

NAK ��

… maximum number of retries = 3.




Response Message

Incorrect Message Response (i.e. Missing ETX or incorrect LRC or invalid

length.)

Terminal records Message Undeliverable

Status��

POS records Message Undeliverable Status




5. MESSAGE STRUCTURE

The messages that are transmitted on the link between the POS and the Terminal will use the

following structure:

STX Length of

Message

Message Data ETX LRC

Transport

Header

Presentation

Header

Field Data

Field

Element

Field

Element

The descriptions of each of the components in the message are listed in the table below:

Field Byte

length

Value Comments

Length of Message 2 The Length of Message field is a 2-byte BCD

format value, starting with the most significant

byte. The maximum allowable value will depend

on the implementation.

For example, a message of 128 bytes would

have this content: 01 28 in the Length of

Message field.

This field allows the inclusion of binary data in the

message.

Message Data Variable As shown in the diagram above, the message data

consists of a Transport Header, a Presentation

Header, and Field Data which consists of one or

more Field Elements.

These different components are more fully

described in the following sections.

LRC 1 The Long Range Checksum is an exclusive OR of

all data bytes contained in between STX and

ETX.

The Long Range Checksum operation includes

the ETX control character, but not the STX.

The Start value for computing the Long Range

Checksum is hexadecimal 0x00.

5.1. Transport Header




The first data in the Message Data is the Transport Header. The Transport Header provides flexibility

in message routing, and allows more than one application to use the same network.

The fields comprising the Transport Header are arranged in the following order:

Transport Header

Transport Header Type Transport Destination Transport Source

The fields’ descriptions are as described below:

Field Byte

length

Value Comments

Transport Header

Type

2 ‘60’ Used to select the type of application this message

is used for.

A value of '60' defines an Application Message.

Transport

Destination

4 ‘XXXX’ Allows the POS to select the destination to which

this message is to be routed.

If the value for ‘XXXX’ is '0000', the Terminal will

determine the correct destination to route the

message to from its internal tables.

Transport Source 4 ‘YYYY’ The first two digits of this field ‘YYYY” must be '00'.

The second two digits can be used by the POS for

any purpose. Typically this will be '00', but if there

are multiple devices (e.g. barcode scanner,

signature capture pads, etc.) connected to the POS,

this field can be used to identify the specific device

the original request originated from.

5.2. Presentation Header

The next data in the Message Data is the Presentation Header. The Presentation Header indicates if

this is a request or a response, the transaction code, a response code, and an indication if there are

more messages associated with this message.

The fields comprising the Presentation Header are arranged in the following order:

Presentation Header

Format

Version

Req-Resp

Indicator

Transaction

Code

Response Code More Data

Indicator

Field Separator





Field Byte

length

Value Comments

Format Version 1 ‘1’ Indicates what format of the messages is

supported. This is for any future updates of

message format. The current version is ‘1’.

Request-Response

Indicator

1 '0' - Indicates a request message which requires a

response.

'1' - Indicates a response message.

'2' - Indicates a request message which does not

require a response

Transaction Code 2 Identifies the type of transaction being performed.

See the table in section for a list of valid

Transaction Codes.

Response Code 2 Identifies the result of the transaction in a

response. Response code should be set to '00' for

all request messages.

See the table in section for a list of valid Response

Codes.

More Data

Indicator

1 '0' - Indicates the last message for this

transaction.

'1' - Indicates that there will be another message

following this one with more field data for this

transaction.

Field Separator 1 1C This field is used to make it easier to identify the

end of the presentation header when looking at

message traces. The value is 1C in hexadecimal.

5.3. Field Data

The Field Data is the most important area for flexibility in the message format.

The method described here allows great benefits, but there is a price to pay for this flexibility;

Each field element has 2 or 5 bytes of overhead.

The benefits gained from this overhead are:

- Ability to pass binary data.

Note: New features such as Signature Capture will require passing large amounts of data.

The overhead required if this cannot be passed as binary data is very high.

- Variable Length Data Fields.




- The data is fairly readable on a message trace.

The Field Data consists of 0 or more Field Elements, arranged one after the other in the message.

Field Data

Field Element1 Field Element

2 Field Element

n-1 Field Elements

n

5.3.1. Field Element Format

The fields comprising the Field Element are arranged in the following order:

Field Element

Field Type Length Data Field Separator


Field Byte

length

Value Comments

Field Type 2 Indicates the type of data that is included in this

field element.

This is an alphanumeric field. Characters 0-9 and A-

Z are available for use.

The table in following sections lists the available

values.

Length 2 The Length of Message field is a 2-byte BCD

format value, starting with the most significant

byte. The maximum allowable value will depend

on the implementation.

For example, a message of 128 bytes would

have this content: 01 28 in the Length of

Message field.

Data Variable The data for this field.

If no data is present in this field (e.g. when the

functionality is indicated by the field type on its

own), there will be no data required.

Field Separator 1 1C This field is used to make it easier to identify the

end of the presentation header when looking at

message traces. The value is 1C in hexadecimal.




5.3.2. Extra Field Separators

In some instances, it will be easier to develop this POS interface if field data appears in a particular

order, with additional field separators to represent fields that are missing.

To support this, it is acceptable to include extra Field Separator characters (1Ch) between Field

Elements.

This can be easily supported in the parsing routine by ignoring any Field Separator characters when it

is expecting the first character of the Field Type.




6. TRANSACTION CODES

Each transaction code is identified with a two character code. Characters 0-9, and A-Z are available

for use in the Transaction Code.

Please note that not ALL transaction codes are supported by specific Terminal (EFT) application(s).

Trans. Code Description

Administrative Transactions

00 Load Authorization Host Telephone Number

01 Load Data Capture Host Telephone Number

02 Load Download Telephone Number

03 Load Initialization Telephone Number

04 Load Check Acceptance Host Telephone Number

06 Load CALL String

07 Load POS Configuration

08 Initialize Parameters – Dial phone number specified by Trans Code 03 and request a

parameter download.

09 Initialize Software – Dial phone number specified by Trans Code 02 and request for a

software download.

Authorization Transactions

10 Authorization Only

12 Check Acceptance

20 Purchase

22 Common EPINS CashOut & HSBC QuickCash

26 Void – Used to VOID a transaction that is still contained in the batch of the Terminal.

27 Credit – Used to REFUND money to a cardholder’s account. This transaction is not

associated with existing transaction in the current batch contained in the Terminal.

28 Tip Adjust – Used to ADJUST a transaction that is being held in the current batch of

the terminal, for adding TIP value in the Food & Beverage implementation types.

34 Balance Inquiry

35 Cash Advance

36 Sale + Cash

37 Ticket Inquiry

38 GPRS Reboot – used only in conjunction with a GPRS based terminal, whenever a

reboot is necessary.

Settlement Transactions

50 Close Batch – Initiate a session with the host to settle all the transactions held in the

current batch in the Terminal.

51 Clear Batch – Used to CLEAR all transactions from the current batch in the terminal.

****** WARNING – ALL TRANSACTION DETAILS WILL BE LOST *******

60 Display 1 -- command to activate and display a message on Display 1 (if available).

61 Display 2 – command to activate and display a message on Display 2 (if available).

62 Key PAD 1 – command to activate KeyPAD1 to accept key entry (if available).

63 Key PAD 2 – command to activate KeyPAD2 to accept key entry (if available).

64 Printer 1 – command to activate and print from Printer 1 (if available).

65 Printer 2 – command to activate and print from Printer 2 (if available).

66 Card Reader 1 – command to activate and read card information from Card Reader 1

(if available).

67 Card Reader 2 – command to activate and read card information from Card Reader 2

(if available).

68 Pin Pad – command to activate the Pin Pad to accept PIN entry (if available)

69 Image Pad – command to activate the Image Pad to display an image (if available).

70 Review Transaction

Options allow for First, Last, Next, Previous or a specific transaction.




75 Review Issuer Total

Options allow for First, Last, Next, Previous or a specific Issuer.

80 Review Acquirer Total

Options allow for First, Last, Next, Previous or a specific Acquirer.

81 Review Terminal Total

82 Hayes Mode Request

83 Training Mode Request

84 Certification Mode Request

85 Transparent Data

86 Dial, Pre-Dial

87 CALL Request

88 CALL Clear

89 TNMS Call -

Dials telephone number specified by Tran Code 02 and start an Network Management

System. The TNMS can be used to perform diagnostics on the

Terminal remotely

90 Report Totals

91 Report Details

92 Duplicate Receipt

D0 Communications Test

Used by the POS to verify the connection to the terminal

D1 Communications Cancel

Used to cancel a transaction that is being processed by the terminal.

93 Bonus Cancel

94 EPP Purchase

E0 Logon

E1 EZL Topup

E2 EZL Debit

E3 EZL Confirm Transaction

E4 EZL Settlement (Reset)

E5 EZL Get Last Settlement

E6 EZL Get Last Transaction

E7 EZL Get CSC Detail

E8 EZL Get CSC Detail Ext.

E9 Non-Cash EZLink Topup

EA EPINS Payment

F0 Enquiry

F1 Redemption & Award

F2 VOID Redemption & Award

F3 REFUND Redemption & Award

F4 EPINS Purchase with Cash Back

F5 EPINS Bill payment

F6 Mobile Airtime Transfer

Generically, below are the currently supported transaction types that are available for Korvac-owned

terminals. [For the sample data, please refer to Appendix A.]

20- Sales/Sale+Cash (Purchase);

26- Void;

27- Refund (Credit);

28- Tip Adjust;

93- Bonus Sales;

E2- EZL Debit;

EA- EPINS Payment;




F0- Enquiry

F1- Redemption&Award

F2- VOID Redemption&Award

F3- REFUND Redemption&Award

50- Close Batch(Settlement)




7. FIELD TYPES

Each different type of Field Element within the Field Data is designated by a different Field Type

value. Each Field Type also has an attribute and a length associated with it. The length may be a

single number, which indicates a fixed length field, or a variable length which indicates a maximum

length. Variable length fields are indicated by two dots preceding the length. For example, Track 1

data is a variable length field up to 76 characters long, which has a length description of ..76.

Field Types are alphanumeric, meaning 0-9 and A-Z are valid characters in the Field Type.

7.1. Field Attributes

The following table lists the different field attributes available for use in the Field Type Definition

Table.

Attribute Description

ANS Alpha, Numeric and Special characters

AN Alpha and Numeric characters

N Numeric characters

Z Numeric Data plus '=' character

This is used for Track 2 data, where the '=' is the separator between the card

number and the rest of the data.

$ Amount.

Numeric characters indicating number of cents. No $ sign or decimal point is

included.

B Binary Data

The data is a stream of bytes that could take any value.

T Telephone Number Data

Valid characters are 0-9, *, #, space, -, and a comma or a P for a dial tone pause.

7.2. Field Type Definitions The following table lists the defined field type definitions with their attributes, and the lengths of

each field.

Field Type Attribute Length Field Data

01 ANS 6 Approval Code / Authorization ID

02 ANS 40 Response Text

40 character text is arranged as two lines of 20

characters

03 N 6 Transaction Date YYMMDD

04 N 6 Transaction Time HHMMSS

06 N 12 Merchant Number

07 N 4 Store Number

08 N 4 Terminal Number

09 N 6 BIN, Acquirer

10 N 6 Agent Number

11 N 6 Chain Number

12 ANS 25 Merchant Name

13 ANS 13 Merchant City

14 ANS 2 Merchant State

15 ANS 4 Merchant Location Number




16 N 8 Terminal Identification Number

17 ANS 1 Cardholder ID Code

20 ANS ..9999 Print Data Formatted

Actual maximum length is determined by the application

30 N ..19 Primary Account Number

31 N 4 Expiration Date YYMM

32 ANS ..76 Track 1 data

Start and end sentinels and LRC are not included.

33 Z ..37 Track 2 data

Start and end sentinels and LRC are not included.

34 ANS 1 Account Data Source

'D' -> Mag-stripe-read, Track 2 capable

'H' -> Mag-stripe-read, Track 1 capable

'T' -> Manual key entered, Track 2 capable

'X' -> Manual key entered, Track 1 capable

'@' -> Manual key entered, not capable or reading card data

40 $ 12 Amount, Transaction

This is the total amount of the transaction. Any other

amounts (such as Tip, Cash Back and Tax) are included in this

amount.

41 $ 12 Amount, Tip Adjust

Information only amount field.

42 $ 12 Amount, Cash Back


43 $ 12 Amount, Tax


50 N 6 Batch Number

51 N 4 Batch Transmission Date - MMDD

52 $ 16 Batch Amount Hashing Total

53 N 9 Batch Transaction Record Count

54 ANS 30 Batch Response Message

60 T ..24 Primary Telephone Number

61 T ..24 Secondary Telephone Number

62 AN 1 Dial Type

'0' - DTMF / Tone Dialing

'1' - Pulse Dialling

63 T ..8 PABX / Tie Line Access Code

64 N 2 Modem mode for dialling

'00' - 1200 bps

'08' - 2400 bps

65 ANS 6 Invoice Number

Used to identify a transaction. There can only be one transaction

with a particular value in the batch in the Terminal.

66 ANS 1 Card Range Selector

This field can be included if it is not possible to use the PAN to

determine the Card Range

'P' Private Label Cards

67 ANS ..6 Employee Number

68 ANS 2, 23, 43, OR

49

Cardholder Identification Data

Refer to Visa Point-Of-Sale Equipment Requirements, PIN

Processing and Data Authentication.




69 ANS ..24 Customer Data, Check Acceptance ID

70 N 3 to 6 Date Data

71 N ..4 Hold Time

Number of seconds to hold the dial line open after a transaction.

'0000' - drops the immediately.

'9999' - holds the line open indefinitely

72 B ..9999 Transparent Data

Actual maximum length is determined by the application

73 ANS 7 Automation ID

For Shell Thai software sales slip printout.

74 ANS 1 Acquirer Number

For Esso Thai software to select the acquirer host

75 ANS 6 Security code ( CVV2 / 4DBC)

Right space, left justify

76 B 54 (Byte) Magneprint Data

89 N 1 OnlyTap

90 $ 12 Amount, Issued


91 $ 12 Amount, Redeemed


92 $ 12 Amount, Balance


93 $ 12 Amount, Nett


94 % 6 Rebate


95 B ..999 Part data of OE field 63

# of transaction pools 1 byte

Pool description 15 bytes

Redeem/Award type 1 byte

Sign 1 byte

Redeem/award point 6 bytes

Redeem/award amount 6 bytes

96 B ..999 Receipt information(See Note 1)

97 ANS 6 Trace no

98 ANS 10 Entry type: Manual/Swipe/Fallback M/Fallback S

/Chip/PAYPASS/PAYWAVE

99 N 3 Ticket Number Redeemed

E0 N 2 Epp Tenor, should be one of 03:06:09:12:18:24:36

E1 $ 12 Amount for the first month

E2 $ 12 Amount for the other month

EMV FIELDS

9A B ..16 AID

9B ANS ..16 AP

9C B 1 Cryptogram Information Data

00 xx xx xx - AAC

01 xx xx xx - TC

10 xx xx xx - ARQC

11 xx xx xx - RFU

9D B 8 Application Cryptogram

9E B 5 TVR

9F B 2 TSI

PREDEFINED FIELDS




D0 ANS 69 Merchant Name and Address

Organized as 3 lines of 23 characters

D1 ANS 15 ISO8583 Merchant Number

D2 ANS 10 Card Issuer Name

D3 ANS 12 Retrieval Reference Number

D4 N 2 Card Issuer ID - From Initialization Tables

D5 ANS 26 Card Holder Name

D6 ANS ..12 Generic Data

D7 ANS ..25 Generic Data 2

D8 ANS 19 Order Number

D9 N 6 STAN

HN N 3 NII

HO N 96 Batch Totals

Capture Sales Count 4

Capture Sales Amount 12

Capture Refund Count 4

Capture Refund Amount 12

Debit Sales Count 4

Debit Sales Amount 12

Debit Refund Count 4

Debit Refund Amount 12

Authorize Sales Count 4

Authorize Sales Amount 12

Authorize Refund Count 4

Authorize Refund Amount 12

HP N 1 Printer Status, Enable Flag, or Binary Flag

0 - Disable

1 - Enable

S1 ANS 2 Product Code 1 ( for Shell Transaction )

S2 $ 12 Litre - No. of litre of Product Code 1 ( for Shell )

S3 ANS 2 Product Code 2 ( for Shell Transaction )

S4 $ 12 Amount #2 - Amount for product code 2 ( for Shell )

F0 ANS 4 Message type

F2 ANS 6 Logon Password

F3 ANS 14 Timestamp

F4 ANS 3 Response Number (See Note 2)

F5 B 4 Device ID

F6 ANS 16 ECR receipt number

F7 ANS 12 Amount in cents

F8 ANS 12 RFU

F9 B 1 Top up Type

FA ANS 14 Terminal TXN

timestamp(DDMMYYYYHHMMSS)

FB ANS 30 Error Description

H0 B 8 CSC Physical ID

H1 ANS 12 Purse Remaining Value

H2 B 4 Purse Sequence Number( PSN/PTC)

H3 B 4 Usage Data Sequence Number (UDSN/UTSN)

H4 B 2 Trans Type

H5 B 2 Trans/Top-up Type

H6 ANS 3 Total number of Top up Transactions

H7 ANS 12 Total amount of Top up Transaction

H8 ANS 3 Total number of Unconfirmed Top up Transactions




H9 ANS 12 Total amount of Unconfirmed Top up Transactions

8A ANS 3 Total number of Debit Transactions

8B ANS 12 Total amount of Debit Transactions

8C ANS 3 Total number of Unconfirmed Debit Transactions

8D ANS 12 Total amount of Unconfirmed Debit Transactions

8E ANS 3 Total number of ePINs Transactions

8F ANS 12 Total amount of ePINs Transactions

8G ANS 2 Last Trans Type

8H B 2 Top-up/Dibit Type

8I ANS 10 CSC ID

8J ANS 16 IDM

8K ANS 2 Valid Ticket Type

8L ANS 8 Valid Ticket Type Expiry Date

8M ANS 3 Auto Top-up Type

8N ANS 12 Top up Amount in cents

8O ANS 12 Convenience Fee in cents

8P ANS 12 Purse Previous Balance

8Q ANS 12 Purse New Balance

8R AN 12 RRN

8S ANS 16 ECR Reference Number

S5 ANS 12 Points Balance

S6 ANS 6 Card Type

S7 ANS 250 Promotional Message

S8 ANS 34 Card Name

S9 ANS 3 Sign

SA ANS 12 Total Redeemed Value

SB ANS 2 Member Type

SC ANS 12 Redeemed Amount

SD ANS 12 Redeemed Points

SE ANS 12 Amount Qualified for Points

SF ANS 6 Authorization ID

SG ANS 12 Latest Points Balance

SH ANS 12 Points Awarded (Earned)

SI ANS 2 No. of Coupons

SJ ANS 30 Coupon 1 Desc 1

SK ANS 30 Coupon 1 Desc 2

SL ANS 30 Coupon 1 Desc 3

SM ANS 30 Coupon 2 Desc 1

SN ANS 30 Coupon 2 Desc 2

SO ANS 30 Coupon 2 Desc 3

SP ANS 30 Coupon 3 Desc 1

SQ ANS 30 Coupon 3 Desc 2

SR ANS 30 Coupon 3 Desc 3

SS ANS 30 Coupon 4 Desc 1

ST ANS 30 Coupon 4 Desc 2

SU ANS 30 Coupon 4 Desc 3

SV ANS 30 Coupon 5 Desc 1

SW ANS 30 Coupon 5 Desc 2

SX ANS 30 Coupon 5 Desc 3

SY ANS 12 Expiring Points

SZ ANS 12 Refund Amount

T1 ANS 12 Points Refunded




T2 ANS 12 Total Amount, or Topup Sent amount

T3 N 12 Cash Back Amount in cents

M0 N 5 Agent ID

M1 N 12 EZR PTS

M2 N 12 MERC PTS

M3 N 6 Top-Up Batch Number

M4 N 6 Debit Batch Number

Mobile Airtime Transfer – TransferTo

TA ANS 6 Country Prefix Code – See appendix C

TB AN 2 Source of Funds –

01 - Cash1

02 to 0A – Others (for future use)

TC AN 15 Msisdn – Sender’s phone number

TD AN 15 Destination Msisdn – Recipient’s phone number

TE AN 3 Originating Currency Code - ISO4217 Currency code

See Appendix B

TF AN 3 Destination Currency Code ISO4217 Currency code

See Appendix B

TG N 12 TransactionID

TH AN 20 Operator – text string containing Telco operator name.

TI AN 20 Country name (String)

Note:

1. Field Type ‘96’ is now used in the DFS application for FxChoice to transfer the receipt

information to the ECR side. This field will be compressed by gzip algorithm in terminal side and

the format is as described below:

COPY (1 byte) + FONT (1 byte) +CONTENT.

- COPY: As the cardholder receipt copy will have the footer, whereas the merchant copy and

bank copy of receipts do not, so we define the COPY = 0x11 for merchant copy, 0x12 for

bank copy and 0x14 for cardholder copy.

As an example, if COPY =0x17, it means this content exist for all copy (merchant/ bank/

cardholder).

- FONT: The terminal supports the normal/bold/large/condensed font, and respectively, the

maximum chars in every line is 34/28/24/42, and the value for this field is

0x11/0x12/0x13/0x14.

- CONTENT: the compressed content of every line on the receipt.

2. Field "F4" is valid for E0/E1/E2/E3/E4/E5/E6/E7/E8/E9/F0/F1/F2/F3. For definition of this field,

please refer to "POS_INTERFACE_SPEC_SMARTEC1.2.pdf", Appendix G.




Response Codes

The following table lists the response codes that the Terminal will send back to the POS in a

response message.

Resp Code Remark

00 Approved

Transaction completed successfully.

01 Voice Referral

Transaction must be completed at the POS using voice referral,

then sent back to the Terminal as an OFFLINE transaction. If the

POS does not support this mode of operation, this response code

can be treated as a declined response code.

ND Declined

The transaction is declined. More explanation is included in the

response text field.

ED Destination Error

Terminal cannot determine where this transaction should be sent

to.

EN Network Request Error

Terminal is unable to make a connection to the host for processing

the transaction, or there is a communication error being

processed.

TO Timeout Error

The Terminal does not receive a response from the host in a set

time.

NA Transaction not available

The Terminal will send this response code if it does not know how

to process the transaction.




8. TRANSACTIONS SUPPORTED

8.1. Purchase / Sale+Cash (Transaction code 20)

Request Message (ECR/POS to Terminal)

Required /

Optional Field

Type Field Name Remarks

REQD 40 Amount, Transaction

OPTL 42 Cash Amount Only for Cash transaction

OPTL D6 Generic Data Only for ECR tangs type

OPTL 65 Invoice Number

OPTL D8 Order Number

OPTL 89 OnlyTap Only for TAP Contactless Sale

OPTL 99 Ticket Number

Redeemed

Only for OE ticket transaction

Response Message (Terminal to POS/ECR)

Required /

Optional Field


REQD 02 Response Text Text will be 40 characters long, organized

as 2 lines of 20 characters

APPR 01 Approval Code

APPR 65 Invoice Number

REQD D0 Merchant Name and

Address

69 characters, organized as 3 lines of 23

characters

APPR 16 Terminal Identification

Number

APPR D1 Merchant Number

APPR D2 Card Issuer Name

APPR 30 Card Number

APPR 31 Expiry Date

APPR 50 Batch Number

REQD 03 Transaction Date

REQD 04 Transaction Time

APPR D3 Retrieval Reference

Number

APPR D4 Card Issuer ID See note 2

OPTL D5 Card Holder Name If available

APPR 90 -

94

Loyalty Info If available

APPR 9A -

9F

EMV Info If available

APPR 95 Field 63 Info If OE available(See note 3)

APPR 96 Receipt information If DCC available

APPR 97 Trace no

APPR 98 Entry type




OPTL D8 Order Number If available and the ECR ORDERNO

REQUIRED flag is true

Note:

1. The Sale+Cash transaction code uses the same message as Purchase, but it should send the

FIELD type 42 containing the Cashout amount. The terminal application will accept it as a

Sale+Cash transaction if this FIELD type 42 is populated. (Please refer to field type

definitions)

2. There are 2 different types of Card issuer ID value, please contact Citibank for the specific

type to use.

Type 1:

04- Visa

05- Master

06- Diners

07- Amex

08- JCB

0F- Others

This is the Hypercom type table (NOT the Hypercom T7 terminal table).

In the terminal application, if the ECR type is set to HYPERCOM type, but set the "CUSCAPI

CARD TYPE" to FALSE, the application will hard code the issuer ID to 04 for all cards when

performing transaction(not Cashout), and hard code the issuer ID to 09 for Cashout

transaction. However, if the “CUSCAPI CARD TYPE” is set to TRUE, the application will send

this table to ECR side.

Type 2: Card Issuer ID value(XY).

This is the table that is used by DFG application.

X: Additional 3 index.

0- On us card

1- Off us card

2- Foreign card

Y: Index table with reference to your terminal application's card table.

0- Reserved

1- Reserved

2- Reserved

3- Reserved

4- VISA

5- Mastercard

6- DINERS

7- AMEX

8- JCB

9- Cash

A- CUP

B- Choice




C- Reserved

D- Reserved

E- Reserved

F- PMPC

3. If OE sale/void (redemption/rebate/coupon) is approved by LH, the terminal application will

send part of the data in the LH DE63 to ECR side (refer to definition of field type 95).

8.2. EPINS Cashout & HSBC QuickCash (Transaction code 22)


Required /

Optional Field


REQD 40 Amount, Transaction The amount is defined as the Purchase

Amount + Cash Amount (in cents

$$$$$$$$$$¢¢).

REQD 42 Cash Amount Equivalent to field T3 of Cash Back Amount

in cents $$$$$$$$$$¢¢.

REQD D6 Generic Data Only for ECR tangs type

REQD 65 Invoice Number

REQD F6 ECR Receipt Number If ECR Receipt number has already been

sent in the previous request, this

transaction would be rejected - this logic is

ONLY applicable to EPINS but this field is

still required to be sent.

REQD F3 Timestamp YYYYMMMDDHHMMSS

Response (Terminal to ECR/POS) - EPINS CashOut is detected

Required /

Optional Field


REQD F0 Message Type F210

REQD F6 ECR Receipt number

REQD F4 Response Number "000" - successful

REQD D1 Merchant ID Mandatory if Response code = "000"

REQD 16 Terminal ID Mandatory if Response Number = "000"

REQD F7 Purchase Amount Mandatory if Response Number = "000"

REQD T3 Cash Back Amount Mandatory if Response Number = "000"

REQD 30 PAN Reserved for future use. To be left blank

REQD 03 Transaction Date Mandatory if Response Number = "000"

REQD 04 Transaction Time Mandatory if Response Number="000"




REQD 01 Approval Code Mandatory if Response Number="000"

REQD 65 Invoice Number Mandatory if Response Number="000"

REQD D2 Card Issuer Name Mandatory if Response Number="000"

REQD D9 STAN Mandatory if Response Number="000"

REQD 8R RRN Mandatory if Response Number="000"

REQD 50 Batch Number Mandatory if Response Number="000"

Response (Terminal to ECR/POS) – HSBC QuickCash is detected

Required /

Optional Field


REQD 02 Response Text Text will be 40 characters long organized as

2 lines of 20 characters




Address


characters


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number

APPR D4 Card Issuer ID See note


APPR 90-94 Loyalty Info If available

APPR 9A-9E EMV Info If available




8.3. Void (Transaction code 26)


Required /

Optional Field



Response (Terminal to ECR/POS)

Required /

Optional Field




APPR 01 Approval Code 69 characters, organized as 3 lines of 23

characters



Address


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number

APPR D4 Card Issuer ID


APPR 95 Field 63 Info If OE available

APPR 96 Receipt information

If DCC available

APPR 97 Trace no

APPR 98 Entry type


REQUIRED flag is TRUE




8.4. Refund – Credit (Transaction code 27)


Required /

Optional Field



OPTL 41 Amount, Tip Adjust

OPTL 30 PAN

OPTL 31 Expiry Date

OPTL 32 Track 1

OPTL 33 Track 2

OPTL D6 Generic Data



Required /

Optional Field





characters



Address


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number



APPR 9A -

9F


APPR 96 Receipt information If DCC available

APPR 97 Trace no

APPR 98 Entry type






8.5. Tip Adjust (Transaction code 28)


Required /

Optional Field



REQD 41 Amount, Tip Adjust


Required /

Optional Field





characters



Address


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number



APPR 9A -

9F


APPR 97 Trace no

APPR 98 Entry type






8.6. Ticket Inquiry (Transaction code 37)


Required /

Optional Field


REQD 89 OnlyTap Only for TAP Contactless Sale


Required /

Optional Field


REQD 02 Response Text Text will be 40 characters long organized

as 2 lines of 20 characters

REQD 99 Ticket Number Redeemed



Number







8.7. Bonus Sales (Transaction code 93)


Required /

Optional Field



OPTL 30 PAN

OPTL 31 Expiry Date

OPTL 32 Track 1

OPTL 33 Track 2


OPTL S1 Product Code 1 Product Code 1 ( for Shell )

OPTL S2 Litre No. of litre of Product Code 1 ( for Shell )


OPTL S4 Amount #2 Amount for Product Code 2 ( for Shell )


Required /

Optional Field




APPR 1 Approval Code 69 characters, organized as 3 lines of

APPR 65 Invoice Number 23 characters


Address


characters


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number



APPR 90 -

94

Loyalty Info If available

APPR 9A -

9F


APPR 97 Trace no

APPR 98 Entry type




8.8. EPP Sales (Transaction code 94)


Required /

Optional Field



OPTL 30 PAN

OPTL 31 Expiry Date

OPTL 32 Track 1

OPTL 33 Track 2



REQD E0 Epp Tenor


OPTL S2 Litre No. of litre of Product Code 1 ( for Shell )


OPTL S4 Amount #2 Amount for Product Code 2 ( for Shell )


Required /

Optional Field







Address


characters


Number



APPR 30 Card Number

APPR 31 Expiry Date





Number



APPR E1-E2 Epp info If available

APPR 97 Trace no

APPR 98 Entry type






8.9. Logon (Transaction code E0)


Required /

Optional Field


REQD F0 Message Type Z820

REQD 16 Terminal ID TID Range "00000000" to "99999999"

REQD F2 Logon Password Logon Password

REQD F3 Timestamp YYYYMMDDHHMMSS


Required /

Optional Field



REQD F4 Response Number "000" - Successful

"090" - Authentication failed

"720" - CD download failed

"2F5" - Wrong password

"2F6" - Param file error

"2F7" - CD file error

"2F8" - Supervisor card error

REQD F5 Device ID




8.10. EZLink Top-up (Transaction code E1)


Required /

Optional Field


REQD F0 Message Type Z2A0

REQD F6 ECR receipt number If ECR Receipt number has already been






REQD F7 Amount in cents "$$$$$$$$$$¢¢"

REQD F8 RFU "000000000000". If the CF flag is set in the

device, the terminal would ignore this field.

REQD F9 Top up Type Cash = 0x11



Required /

Optional Field


REQD F0 Message Type Z2B0

REQD F6 ECR receipt number

REQD F4 Response Number

REQD F5 Device ID

REQD FA Terminal TXN timestamp DDMMYYYYHHMMSS

REQD H0 CSC Physical ID Physical ID of CSC MSB 4 bytes of the field

would be 0x00 for Type C card in hex value.

Type B card is in BCD format.

Mandatory if Response Number=“000”

REQD F9 Top up Type Mandatory if Response Number=“000”



REQD F8 RFU "000000000000"


REQD H1 Purse Remaining Value "$$$$$$$$$$¢¢"


REQD H2 Purse Sequence

Number( PSN/PTC)




REQD H3 Usage Data Sequence

Number

Usage Data Sequence number associated

with top up transaction.


REQD FB Error Description Mandatory if Response code!="000"

REQD D1 Merchant ID Mandatory if terminal is a PINPAD

REQD M0 Agent ID Mandatory if terminal is a PINPAD

REQD D9 STAN Mandatory if terminal is a PINPAD

REQD 8R RRN Mandatory if terminal is a PINPAD




REQD SF AUTH ID Mandatory if terminal is a PINPAD

REQD 50 Batch Number Mandatory if terminal is a PINPAD

REQD 8P Previous Balance Mandatory if terminal is a PINPAD

REQD M1 EZR PTS Mandatory if terminal is a PINPAD

Returns NULL if no value

REQD M2 MERC PTS Mandatory if terminal is a PINPAD





8.11. EZLink Debit (Transaction code E2)


Required /

Optional Field



REQD F6 ECR receipt number If ECR Receipt number has already been









Required /

Optional Field





REQD F5 Device ID

REQD FA Terminal TXN timestamp DDMMYYYYHHMMSS(Not applicable to DFG

POS)

REQD H0 CSC Physical ID MSB 4 bytes of the field would be 0x00 for Type

C card in hex value. Type B card is in BCD

format.


REQD H4 Trans Type BCD data type


0x68 - Debit

0x69 - Autoload



REQD F8 RFU "000000000000"





Number( PSN/PTC)





Number

Usage Data Sequence number associated with

top up transaction.


REQD D1 Merchant ID Mandatory if terminal is a PINPAD

REQD M0 Agent ID Mandatory if terminal is a PINPAD

REQD D9 STAN Mandatory if terminal is a PINPAD

RFU - returns NULL value

REQD 8R RRN Mandatory if terminal is a PINPAD





REQD SF AUTH ID Mandatory if terminal is a PINPAD


REQD 50 Batch Number Mandatory if terminal is a PINPAD

REQD 8P Previous Balance Mandatory if terminal is a PINPAD

REQD M1 EZR PTS Mandatory if terminal is a PINPAD


REQD M2 MERC PTS Mandatory if terminal is a PINPAD





8.12. EZLink Confirm Trans (Transaction code E3)


Required /

Optional Field







Required /

Optional Field





REQD F5 Device ID





REQD H5 Trans/Top-up Type Mandatory if Response Number=“000”

0x11 - Top up

0x68 - Debit

0x69 - Autoload



REQD F8 RFU "000000000000"





Number( PSN/PTC)





Number







8.13. EZLink Settlement / Reset (Transaction code E4)


Required /

Optional Field







Required /

Optional Field





REQD F5 Device ID

Batch Total Mandatory if Response code = "000".

REQD H6 Total number of Top up

Transactions

000 to 999


REQD H7 Total amount of Top up

Transactions

"$$$$$$$$$$¢¢"


REQD H8 Total number of

Unconfirmed Top up

Transactions

000 to 999


REQD H9 Total amount of

Unconfirmed Top up

Transactions

"$$$$$$$$$$¢¢"


REQD F8 RFU "000000000000"


REQD 8A Total number of Debit

Transactions

000 to 999


REQD 8B Total amount of Debit

Transactions

"$$$$$$$$$$¢¢"


REQD 8C Total number of

Unconfirmed Debit

Transactions

000 to 999


REQD 8D Total amount of

Unconfirmed Debit

Transactions

"$$$$$$$$$$¢¢"


EPINs Total

REQD 8E Total number of EPINs

Transactions

REQD 8F Total amount of EPINs

Transactions

REQD M3 Top-Up Batch Number

REQD M4 Debit Batch Number




8.14. EZLink GetLastSettle (Transaction code E5)


Required /

Optional Field


REQD F0 Message Type Z6A0




Required /

Optional Field


REQD F0 Message Type Z6B0



"6BF" - Settle Table empty

REQD F5 Device ID

Batch Total

REQD H6 Total number of Top up

Transactions

000 to 999


REQD H7 Total amount of Top up

Transactions

"$$$$$$$$$$¢¢"


REQD H8 Total number of

Unconfirmed Top up

Transactions

000 to 999


REQD H9 Total amount of

Unconfirmed Top up

Transactions

"$$$$$$$$$$¢¢"


REQD F8 RFU "000000000000"


REQD 8A Total number of Debit

Transactions

000 to 999


REQD 8B Total amount of Debit

Transactions

"$$$$$$$$$$¢¢"


REQD 8C Total number of

Unconfirmed Debit

Transactions

000 to 999


REQD 8D Total amount of

Unconfirmed Debit

Transactions

"$$$$$$$$$$¢¢"


REQD M3 Top-Up Batch Number

REQD M4 Debit Batch Number




8.15. EZLink GetLastTrans (Transaction code E6)


Required /

Optional Field






Required /

Optional Field




REQD F4 Response Number "69F" - Trans Table Empty or Last Transaction

Response Code

REQD 8G Last Trans Type "DE" - Debit

"TU" - Top-up

"AL" - Autoload

REQD F5 Device ID



format.


REQD 8H Top-up/Debit Type Mandatory if Response Number=“000”



REQD F8 RFU "000000000000"





Number( PSN/PTC)


REQD F3 Timestamp DDMMYYYYHHMMSS



Number

Usage Data Sequence number associated with

top up transaction.





8.16. EZLink GetCSCDetail (Transaction code E7)


Required /

Optional Field



REQD F6 ECR Receipt Number




Required /

Optional Field




REQD F5 Device ID



format.




If the card remaining value is negative, a '-' sign

would be appended before the value.


Number( PSN/PTC)





8.17. EZLink GetCSCDetailExt (Transaction code E8)


Required /

Optional Field



REQD F6 ECR Receipt Number




Required /

Optional Field




REQD F5 Device ID

REQD H0 CSC Physical ID MSB 4 bytes of the field would be 0x00 for

Type C card in hex value. Type B card is in

BCD format.


REQD 8I CSC ID Mandatory if Response Number=“000”

This is the value as printed on the card

but w/o the last digit which is a Check

Digit.

e.g. 0093433389

REQD 8J IDM Mandatory if Response Number=“000”



If the card remaining value is negative, a '-'

sign would be appended before the value.


Number( PSN/PTC)


REQD 8K Valid Ticket Type e.g. "32" Adult anonymous

REQD 8L Valid Ticket Type Expiry

Date

YYYYMMDD

REQD 8M Auto Top-up Type "999" - Disabled

"000" or "127" - GIRO

"001" - VISA

"002" - MC

"003" to "126" - Undefined




8.18. Non-Cash EZLink Top-up (Transaction code E9)


Required /

Optional Field


REQD F0 Message Type E200

REQD F6 ECR Receipt Number If ECR Receipt number has already been


transaction would be rejected.


REQD 8N Topup Amount in cents "$$$$$$$$$$¢¢"

REQD 8O Convenience Fee in cents "$$$$$$$$$$¢¢"



Required /

Optional Field


REQD F0 Message Type E210



REQD F5 Device ID





REQD 8N Top up Amount in cents "$$$$$$$$$$¢¢"

REQD 8P Purse Previous Balance "$$$$$$$$$$¢¢"

REQD 8Q Purse New Balance Mandatory if Response Number=“000”


Number( PSN/PTC)





Number(UDSN/UTSN)



REQD D1 Merchant ID Mandatory if Response Number=“000”

REQD 16 Terminal ID Mandatory if Response Number=“000”

REQD 40 Amount, Transaction Mandatory if Response Number=“000”

Sum of Topup and CF amt

REQD 30 Primary Account Number Mandatory if Response Number=“000”

1st 6 and Last 4 digits are shown

REQD 03 Transaction Date Mandatory if Response Number=“000”

REQD 04 Transaction Time Mandatory if Response Number=“000”

REQD 01 Approval Code Mandatory if Response Number=“000”

REQD 65 Invoice Number Mandatory if Response Number=“000”

REQD D2 Card Issuer Name Mandatory if Response Number=“000”

REQD D9 STAN Mandatory if Response Number=“000”

REQD 8R RRN Mandatory if Response Number=“000”

REQD 50 Batch Number Mandatory if Response Number=“000”




8.19. EPINS Payment (Transaction code EA)


Required /

Optional Field


REQD F0 Message Type D200

REQD 8S ECR Receipt Number If ECR Receipt number has already been


transaction would be rejected.




Required /

Optional Field


REQD F0 Message Type D210

REQD 8S ECR Receipt Number


REQD D1 Merchant ID

REQD 16 Terminal ID


REQD 30 Primary Account Number 1st 6 and Last 4 digits shown



REQD 01 Approval Code


REQD D2 Card Issuer Name

REQD D9 STAN

REQD 8R RRN

REQD 50 Batch Number




8.20. Enquiry (Transaction code F0)


Required /

Optional Field


REQD F0 Message Type B200




Required /

Optional Field


REQD F0 Message Type B210





REQD H0 CSC Physical ID CEPAS card is in BCD format.



REQD S5 Points Balance Current Point Balance

"9999999999v99"


REQD S6 Card Type Identify the type of card presented.


REQD S7 Promotional Message Promotional Message at per customer.

On terminal this is to be displayed as 10

lines of 24 characters. This will make up of

50 characters (Member Tier) + 200

(Merchant Promotional Message)


REQD S8 Card Name Name on Card


REQD S9 Sign <space><space>$ for dollar value

PTS for points value


REQD SA Total Redeemed Value "9999999999v99"


REQD SB Member Type 00- Non Member

01- PA

02- EZR

03- PA & EZR


REQD SY Expiring Points Points expiring in a certain time frame,

9999999999v99 Mandatory if Response

Number=“000”




8.21. Redemption & Award (Transaction code F1)


Required /

Optional Field


REQD F0 Message Type C200

REQD F6 ECR receipt number This ECR receipt number is one of the fields

use to identify this transaction for matching

purposes.



REQD SC Redeemed Amount The actual amount redeemed in this

transaction.

"9999999999v99"

REQD SE Amount Qualified for

Points

The amount the member qualifies for

points issuance

"9999999999v99"

REQD T2 Total Amount This is the amount before redemption

"9999999999v99"



Required /

Optional Field


REQD F0 Message Type C210







REQD SF Authorization ID Mandatory if Response Number=“000”

REQD 8R RRN Retrieval Reference Number


REQD SG Latest Points Balance Point Balance "9999999999v99"


REQD SH Points Awarded (Earned) Based on Qualified Amount provided

"9999999999v99"


REQD SD Points Redeemed "9999999999v99"

Points redeemed in the current transaction













REQD SI No. of Coupons No. of coupons - Restrict to 5 for now

hence n = 5 max

REQD SJ Coupon 1 Desc 1 Coupon Description 1

REQD SK Coupon 1 Desc 2 Coupon Description 2

REQD SL Coupon 1 Desc 3 Coupon Description 3

REQD SM Coupon 2 Desc 1 Coupon Description 1

REQD SN Coupon 2 Desc 2 Coupon Description 2

REQD SO Coupon 2 Desc 3 Coupon Description 3

REQD SP Coupon 3 Desc 1 Coupon Description 1

REQD SQ Coupon 3 Desc 2 Coupon Description 2

REQD SR Coupon 3 Desc 3 Coupon Description 3

REQD SS Coupon 4 Desc 1 Coupon Description 1

REQD ST Coupon 4 Desc 2 Coupon Description 2

REQD SU Coupon 4 Desc 3 Coupon Description 3

REQD SV Coupon 5 Desc 1 Coupon Description 1

REQD SW Coupon 5 Desc 2 Coupon Description 2

REQD SX Coupon 5 Desc 3 Coupon Description 3


9999999999v99





8.22. Void Redemption & Award (Transaction code F2)


Required /

Optional Field


REQD F0 Message Type V200



purposes.


REQD 8R RRN Retrieval Reference Number (for identifying

the transaction to void)



Required /

Optional Field


REQD F0 Message Type V210













8.23. Refund Redemption & Award (Transaction code F3)


Required /

Optional Field


REQD F0 Message Type R200



purposes.



REQD SC Redeemed Amount All values set to zero

"9999999999v99"

REQD SZ Refund Amount

This is the amount required for the host to

reverse the points.

"9999999999v99"



Required /

Optional Field


REQD F0 Message Type R210










REQD SG Latest Points Balance Point Balance "9999999999v99"


REQD SG Points Refunded This is the points reversed.

"9999999999v99"


REQD SD Points Redeemed "9999999999v99"

Points redeemed in the current transaction










REQD SI No. of Coupons No. of coupons - Restrict to 5 for now

hence n = 5 max

REQD SJ Coupon 1 Desc 1 Coupon Description 1

REQD SK Coupon 1 Desc 2 Coupon Description 2




REQD SL Coupon 1 Desc 3 Coupon Description 3

REQD SM Coupon 2 Desc 1 Coupon Description 1

REQD SN Coupon 2 Desc 2 Coupon Description 2

REQD SO Coupon 2 Desc 3 Coupon Description 3

REQD SP Coupon 3 Desc 1 Coupon Description 1

REQD SQ Coupon 3 Desc 2 Coupon Description 2

REQD SR Coupon 3 Desc 3 Coupon Description 3

REQD SS Coupon 4 Desc 1 Coupon Description 1

REQD ST Coupon 4 Desc 2 Coupon Description 2

REQD SU Coupon 4 Desc 3 Coupon Description 3

REQD SV Coupon 5 Desc 1 Coupon Description 1

REQD SW Coupon 5 Desc 2 Coupon Description 2

REQD SX Coupon 5 Desc 3 Coupon Description 3


9999999999v99





8.24. EPINS Purchase with Cash Back (Transaction code F4)


Required /

Optional Field



REQD F6 ECR Receipt number If ECR Receipt number already sent in the

previous request, this transaction would be

rejected.

REQD F7 Purchase Amount in

cents

"$$$$$$$$$$¢¢"

REQD T3 Cash Back Amount in

cents

"$$$$$$$$$$¢¢"



Required /

Optional Field







REQD F7 Purchase Amount Mandatory if Response Number=“000”

REQD T3 Cash Back Amount Mandatory if Response Number=“000”













8.25. EPINS Bill Payment (Transaction code F5)


Required /

Optional Field


REQD F0 Message Type G200 – Debit Card payment



rejected.


cents

"$$$$$$$$$$¢¢"



Required /

Optional Field


REQD F0 Message Type "G210" Debit Card Payment Response


















8.26. Mobile Airtime Transfer (Transaction code F6)


Required /

Optional Field


REQD F0 Message Type M200



rejected.


cents

Airtime Transfer amount.


REQD TA Country Prefix Code Country Prefix Code – See appendix C

REQD TB Source of Funds 01 - Cash1

02 to 0A – Others (for future use)


Required /

Optional Field


REQD F0 Message Type M210

REQD F6 ECR Receipt number Echo original message.

REQD F4 Response Number "000" if Successful.











REQD TC Msisdn

REQD TD Dest Msisdn

REQD 02 Error text Error text as provided by terminal application.

REQD TE Originating Currency Originating currency code

REQD TF Destination Currency Destination currency code

REQD T2 Topup Sent Amount "$$$$$$$$$$¢¢"

Returns the amount transferred in the currency

of the destination number, in cents. REQD HP SMS Send 0 - No, 1 – Yes

REQD TH Operator Destination operator

REQD TI Country Destination country




APPENDIX A: SAMPLE DATA OF TRANSACTIONS

SALE

02005036303030303030303030313032303030301c343000123030303030303030313131311c4

436001031323334

3536373839301c030F

SALE+CASH (Purchase)

02005236303030303030303030313032303030301c343000123030303030303030373030301c3

43200123030303030303030353030301c0378

BONUS SALE

02005036303030303030303030313039333030301c343000123030303030303030313131311c4

436001031323334

3536373839301c0307

VOID

02002936303030303030303030313032363030301c363500063030313131331c031E

REFUND

02005036303030303030303030313032373030301c343000123030303030303030313131311c4

4360010313233343536373839301c0308




APPENDIX B: IS04217 CURRENCY CODE

Code Country Name Code Country Name

AED United Arab Emirates Dirham LKR Sri Lanka Rupee

AFN Afghanistan Afghani LRD Liberia Dollar

ALL Albania Lek LSL Lesotho Loti

AMD Armenia Dram LTL Lithuania Litas

ANG Netherlands Antilles Guilder LVL Latvia Lat

AOA Angola Kwanza LYD Libya Dinar

ARS Argentina Peso MAD Morocco Dirham

AUD Australia Dollar MDL Moldova Leu

AWG Aruba Guilder MGA Madagascar Ariary

AZN Azerbaijan New Manat MKD Macedonia Denar

BAM Bosnia and Herzegovina

Convertible Marka

MMK Myanmar (Burma) Kyat

BBD Barbados Dollar MNT Mongolia Tughrik

BDT Bangladesh Taka MOP Macau Pataca

BGN Bulgaria Lev MRO Mauritania Ouguiya

BHD Bahrain Dinar MUR Mauritius Rupee

BIF Burundi Franc MVR Maldives (Maldive Islands)

Rufiyaa

BMD Bermuda Dollar MWK Malawi Kwacha

BND Brunei Darussalam Dollar MXN Mexico Peso

BOB Bolivia Boliviano MYR Malaysia Ringgit

BRL Brazil Real MZN Mozambique Metical

BSD Bahamas Dollar NAD Namibia Dollar

BTN Bhutan Ngultrum NGN Nigeria Naira

BWP Botswana Pula NIO Nicaragua Cordoba

BYR Belarus Ruble NOK Norway Krone

BZD Belize Dollar NPR Nepal Rupee

CAD Canada Dollar NZD New Zealand Dollar

CDF Congo/Kinshasa Franc OMR Oman Rial

CHF Switzerland Franc PAB Panama Balboa

CLP Chile Peso PEN Peru Nuevo Sol

CNY China Yuan Renminbi PGK Papua New Guinea Kina

COP Colombia Peso PHP Philippines Peso

CRC Costa Rica Colon PKR Pakistan Rupee

CUC Cuba Convertible Peso PLN Poland Zloty

CUP Cuba Peso PYG Paraguay Guarani

CVE Cape Verde Escudo QAR Qatar Riyal

CZK Czech Republic Koruna RON Romania New Leu

DJF Djibouti Franc RSD Serbia Dinar

DKK Denmark Krone RUB Russia Ruble

DOP Dominican Republic Peso RWF Rwanda Franc

DZD Algeria Dinar SAR Saudi Arabia Riyal

EGP Egypt Pound SBD Solomon Islands Dollar

ERN Eritrea Nakfa SCR Seychelles Rupee

ETB Ethiopia Birr SDG Sudan Pound

EUR Euro Member Countries SEK Sweden Krona

FJD Fiji Dollar SGD Singapore Dollar

FKP Falkland Islands (Malvinas)

Pound

SHP Saint Helena Pound

GBP United Kingdom Pound SLL Sierra Leone Leone

GEL Georgia Lari SOS Somalia Shilling




GGP Guernsey Pound SPL* Seborga Luigino

GHS Ghana Cedi SRD Suriname Dollar

GIP Gibraltar Pound STD São Principe and Tome Dobra

GMD Gambia Dalasi SVC El Salvador Colon

GNF Guinea Franc SYP Syria Pound

GTQ Guatemala Quetzal SZL Swaziland Lilangeni

GYD Guyana Dollar THB Thailand Baht

HKD Hong Kong Dollar TJS Tajikistan Somoni

HNL Honduras Lempira TMT Turkmenistan Manat

HRK Croatia Kuna TND Tunisia Dinar

HTG Haiti Gourde TOP Tonga Pa'anga

HUF Hungary Forint TRY Turkey Lira

IDR Indonesia Rupiah TTD Trinidad and Tobago Dollar

ILS Israel Shekel TVD Tuvalu Dollar

IMP Isle of Man Pound TWD Taiwan New Dollar

INR India Rupee TZS Tanzania Shilling

IQD Iraq Dinar UAH Ukraine Hryvna

IRR Iran Rial UGX Uganda Shilling

ISK Iceland Krona USD United States Dollar

JEP Jersey Pound UYU Uruguay Peso

JMD Jamaica Dollar UZS Uzbekistan Som

JOD Jordan Dinar VEF Venezuela Bolivar Fuerte

JPY Japan Yen VND Viet Nam Dong

KES Kenya Shilling VUV Vanuatu Vatu

KGS Kyrgyzstan Som WST Samoa Tala

KHR Cambodia Riel XAF Communauté Financière

Africaine (BEAC) CFA Franc BEAC

KMF Comoros Franc XCD East Caribbean Dollar

KPW Korea (North) Won XDR International Monetary Fund

(IMF) Special Drawing Rights

KRW Korea (South) Won XOF Communauté Financière

Africaine (BCEAO) Franc

KWD Kuwait Dinar XPF Comptoirs Français du Pacifique

(CFP) Franc

KYD Cayman Islands Dollar YER Yemen Rial

KZT Kazakhstan Tenge ZAR South Africa Rand

LAK Laos Kip ZMK Zambia Kwacha

LBP Lebanon Pound ZWD Zimbabwe Dollar

APPENDIX C: INTERNATIONAL TELCOM COUNTRY CODE

Country

ISO Telcom

Country Codes

Country

Prefix

Code Country

ISO Telcom

Country Codes

Country

Prefix

Code

Afghanistan AF / AFG 93 Libya LY / LBY 218

Albania AL / ALB 355 Liechtenstein LI / LIE 423

Algeria DZ / DZA 213 Lithuania LT / LTU 370

American

Samoa AS / ASM 1 684 Luxembourg LU / LUX 352

Andorra AD / AND 376 Macau MO / MAC 853

Angola AO / AGO 244 Macedonia MK / MKD 389

Anguilla AI / AIA 1 264 Madagascar MG / MDG 261

Antarctica AQ / ATA 672 Malawi MW / MWI 265




Antigua and

Barbuda AG / ATG 1 268 Malaysia MY / MYS 60

Argentina AR / ARG 54 Maldives MV / MDV 960

Armenia AM / ARM 374 Mali ML / MLI 223

Aruba AW / ABW 297 Malta MT / MLT 356

Australia AU / AUS 61 Marshall Islands MH / MHL 692

Austria AT / AUT 43 Mauritania MR / MRT 222

Azerbaijan AZ / AZE 994 Mauritius MU / MUS 230

Bahamas BS / BHS 1 242 Mayotte YT / MYT 262

Bahrain BH / BHR 973 Mexico MX / MEX 52

Bangladesh BD / BGD 880 Micronesia FM / FSM 691

Barbados BB / BRB 1 246 Moldova MD / MDA 373

Belarus BY / BLR 375 Monaco MC / MCO 377

Belgium BE / BEL 32 Mongolia MN / MNG 976

Belize BZ / BLZ 501 Montenegro ME / MNE 382

Benin BJ / BEN 229 Montserrat MS / MSR 1 664

Bermuda BM / BMU 1 441 Morocco MA / MAR 212

Bhutan BT / BTN 975 Mozambique MZ / MOZ 258

Bolivia BO / BOL 591 Namibia NA / NAM 264

Bosnia and

Herzegovina BA / BIH 387 Nauru NR / NRU 674

Botswana BW / BWA 267 Nepal NP / NPL 977

Brazil BR / BRA 55 Netherlands NL / NLD 31

British Indian

Ocean Territory IO / IOT

Netherlands

Antilles AN / ANT 599

British Virgin

Islands VG / VGB 1 284 New Caledonia NC / NCL 687

Brunei BN / BRN 673 New Zealand NZ / NZL 64

Bulgaria BG / BGR 359 Nicaragua NI / NIC 505

Burkina Faso BF / BFA 226 Niger NE / NER 227

Burma

(Myanmar) MM / MMR 95 Nigeria NG / NGA 234

Burundi BI / BDI 257 Niue NU / NIU 683

Cambodia KH / KHM 855 Norfolk Island / NFK 672

Cameroon CM / CMR 237 North Korea KP / PRK 850

Canada CA / CAN 1

Northern

Mariana Islands MP / MNP 1 670

Cape Verde CV / CPV 238 Norway NO / NOR 47

Cayman Islands KY / CYM 1 345 Oman OM / OMN 968

Central African

Republic CF / CAF 236 Pakistan PK / PAK 92

Chad TD / TCD 235 Palau PW / PLW 680

Chile CL / CHL 56 Panama PA / PAN 507

China CN / CHN 86

Papua New

Guinea PG / PNG 675

Christmas Island CX / CXR 61 Paraguay PY / PRY 595

Cocos (Keeling)

Islands CC / CCK 61 Peru PE / PER 51

Colombia CO / COL 57 Philippines PH / PHL 63

Comoros KM / COM 269 Pitcairn Islands PN / PCN 870

Cook Islands CK / COK 682 Poland PL / POL 48

Costa Rica CR / CRC 506 Portugal PT / PRT 351




Croatia HR / HRV 385 Puerto Rico PR / PRI 1

Cuba CU / CUB 53 Qatar QA / QAT 974

Cyprus CY / CYP 357

Republic of the

Congo CG / COG 242

Czech Republic CZ / CZE 420 Romania RO / ROU 40

Democratic

Republic of the

Congo CD / COD 243 Russia RU / RUS 7

Denmark DK / DNK 45 Rwanda RW / RWA 250

Djibouti DJ / DJI 253

Saint

Barthelemy BL / BLM 590

Dominica DM / DMA 1 767 Saint Helena SH / SHN 290

Dominican

Republic DO / DOM 1 809

Saint Kitts and

Nevis KN / KNA 1 869

Ecuador EC / ECU 593 Saint Lucia LC / LCA 1 758

Egypt EG / EGY 20 Saint Martin MF / MAF 1 599

El Salvador SV / SLV 503

Saint Pierre and

Miquelon PM / SPM 508

Equatorial

Guinea GQ / GNQ 240

Saint Vincent

and the

Grenadines VC / VCT 1 784

Eritrea ER / ERI 291 Samoa WS / WSM 685

Estonia EE / EST 372 San Marino SM / SMR 378

Ethiopia ET / ETH 251

Sao Tome and

Principe ST / STP 239

Falkland Islands FK / FLK 500 Saudi Arabia SA / SAU 966

Faroe Islands FO / FRO 298 Senegal SN / SEN 221

Fiji FJ / FJI 679 Serbia RS / SRB 381

Finland FI / FIN 358 Seychelles SC / SYC 248

France FR / FRA 33 Sierra Leone SL / SLE 232

French

Polynesia PF / PYF 689 Singapore SG / SGP 65

Gabon GA / GAB 241 Slovakia SK / SVK 421

Gambia GM / GMB 220 Slovenia SI / SVN 386

Gaza Strip / 970 Solomon Islands SB / SLB 677

Georgia GE / GEO 995 Somalia SO / SOM 252

Germany DE / DEU 49 South Africa ZA / ZAF 27

Ghana GH / GHA 233 South Korea KR / KOR 82

Gibraltar GI / GIB 350 Spain ES / ESP 34

Greece GR / GRC 30 Sri Lanka LK / LKA 94

Greenland GL / GRL 299 Sudan SD / SDN 249

Grenada GD / GRD 1 473 Suriname SR / SUR 597

Guam GU / GUM 1 671 Svalbard SJ / SJM

Guatemala GT / GTM 502 Swaziland SZ / SWZ 268

Guinea GN / GIN 224 Sweden SE / SWE 46

Guinea-Bissau GW / GNB 245 Switzerland CH / CHE 41

Guyana GY / GUY 592 Syria SY / SYR 963

Haiti HT / HTI 509 Taiwan TW / TWN 886

Holy See

(Vatican City) VA / VAT 39 Tajikistan TJ / TJK 992

Honduras HN / HND 504 Tanzania TZ / TZA 255

Hong Kong HK / HKG 852 Thailand TH / THA 66

Hungary HU / HUN 36 Timor-Leste TL / TLS 670




Iceland IS / IS 354 Togo TG / TGO 228

India IN / IND 91 Tokelau TK / TKL 690

Indonesia ID / IDN 62 Tonga TO / TON 676

Iran IR / IRN 98

Trinidad and

Tobago TT / TTO 1 868

Iraq IQ / IRQ 964 Tunisia TN / TUN 216

Ireland IE / IRL 353 Turkey TR / TUR 90

Isle of Man IM / IMN 44 Turkmenistan TM / TKM 993

Israel IL / ISR 972

Turks and Caicos

Islands TC / TCA 1 649

Italy IT / ITA 39 Tuvalu TV / TUV 688

Ivory Coast CI / CIV 225 Uganda UG / UGA 256

Jamaica JM / JAM 1 876 Ukraine UA / UKR 380

Japan JP / JPN 81

United Arab

Emirates AE / ARE 971

Jersey JE / JEY United Kingdom GB / GBR 44

Jordan JO / JOR 962 United States US / USA 1

Kazakhstan KZ / KAZ 7 Uruguay UY / URY 598

Kenya KE / KEN 254 US Virgin Islands VI / VIR 1 340

Kiribati KI / KIR 686 Uzbekistan UZ / UZB 998

Kosovo / 381 Vanuatu VU / VUT 678

Kuwait KW / KWT 965 Venezuela VE / VEN 58

Kyrgyzstan KG / KGZ 996 Vietnam VN / VNM 84

Laos LA / LAO 856

Wallis and

Futuna WF / WLF 681

Latvia LV / LVA 371 West Bank 970

Lebanon LB / LBN 961 Western Sahara EH / ESH

Lesotho LS / LSO 266 Yemen YE / YEM 967

Liberia LR / LBR 231 Zambia ZM / ZMB 260

Zimbabwe ZW / ZWE 263

document

Documents

interface request

document number version

smartec ecr integration

response message format

physical interface

published date

document classification

revised section