ATM/POS MANAGEMENT

Message Flow Overview

Mapping

Switch/ ISO-
8583 Listener OFS
CMS

T24 Core
 Setup

Steps to Setup ATM/POS:

1. Install the package (Please follow installation
guide: BIDC_ATM_Interface_Installation
Guide.pdf)
2. Install and Configure listener (demo, more
detail in installation guide:
BIDC_ATM_Interface_Installation Guide.pdf)
3. Review message mapping and Configure GL
parameter in T24
Install and Setup listener
Install and Setup listener

1. Install TCServer (demo), make sure you have

java and set JAVA_HOME as environment
variable
2. Define adapter and listener in tcserver.xml
tcserver.xml is in following folder:
../ [tcserver home dir]/conf/TCServer
Install and Setup listener

Change <STARTIN> and <JBASEPATH> to proper directory

Install and Setup listener

Make sure you have OFS.SOURCE name “ATM” as below

 Install and Setup listener

3. Listener logging setup: configure tcslog.properties under …/conf as follow

Install and Setup listener

Now start TCServer

Go to [tcserver home dir]/bin
Type: sh TCServer.sh
Wait for starting
Setup parameter in T24
 Setup parameter in T24

ISO request INTRF.MESSAGE

(Message parse)

Identify mapping ID
(MTI + processing
code)
INTRF.MAPPING
(Translate to OFS)

Post OFS to T24

(FUNDS.TRANSFER)

Success
?
Y N
Approve Txn Reject Txn

INTRF.MESSAGE
Message parse ISO response
Concept

Message mapping

- MESSAGE MAPPING is feature to let‟s customer amend,

reconfigure, create new type of transaction
- Let you map m – n between ISO message field and T24
Application field
- Let you re-format data before come to T24 Application
- Include: INTRF.MASSAGE (parse message) and
INTRF.MAPPING (mapping message)
Concept

OFS

- OFS means Open Finance Service

- Format message from ISO format to T24 format
- Standard method to post transaction into T24 system
- Validate user, validate data, error checking, log
- Process and response transaction result
- Refer OFS user guide for more detail
- Example OFS:
FUNDS.TRANSFER,ATM/I/PROCESS,TEMENOS01/*******/KH0010001,,TRAN
SACTION.TYPE:1:1=ACAW,DEBIT.ACCT.NO:1:1=100000000056,DEBIT.CURR
ENCY:1:1=840,CREDIT.AMOUNT:1:1=000000015900,CREDIT.ACCT.NO:1:1=U
SD100410001,CREDIT.CURRENCY:1:1=840,AT.UNIQUE.ID:1:1=20006031357
41262847123400,
Concept

FUNDS TRANSFER

- FUNDS.TRANSFER is standard application to process

ATM/POS transaction
- Support non-stop feature to accept ATM transactions 24/24
- Can process many types of account: GL account, customer
account, Nostro account…
- Support Fee & VAT collection
Setup parameter in T24

User and Type of Transaction

- Create default users to post OFS into T24 with sign on name as
below:
TEMENOS01/123456
TEMENOS02/123456
TEMENOS03/123456
- Use FT.TXN.TYPE.CONDITION to define transaction type
- Workshop: View some defined transaction type for ATM and
POS: ACAW, ACAT, ACAR, ACPS, ACPR
- Workshop: see how transaction types and users are mapped in
INTRF.MAPPING
 Setup parameter in T24

ATM Parameter
This is a parameter file, which stores the various details like the Network
identification for the ATMs, the path for file used for balance upload which
will store the information in the message. Important fields:
Field Name Len Description
BANK.IMD 6 Bank identification number
NETWORK.IMD 6 Optional field which store BIN number of Network. For using a
separate Credit account for POS transactions the Bin number
should be appended with „-POS‟
NET.IMD.CATEG 6 The category code used for forming Credit Account for a
particular Network
NET.IMD.AC.SUFX 4 Suffix used for forming the Credit Account for a particular
Network.
NET.IMD.INT.AC 16 This stores the internal account that will be used in any
accounting process involving the associated multi value field
NETWORK.IMD field. This account no should exist in the
ACCOUNT table.
Setup parameter in T24
 Setup parameter in T24

ATM.BRANCH
Stores the details like which ATM machine belongs to which
branch in T24. Important fields:
Field Name Len Description
ID 6 Unique for each branch
COMPANY.CODE 9 This field stores the Globus company to which the ATM belongs
DEVICE.ID 4 This is a mandatory field and part of the multi value associated
field. If this is inputted then either of the field/s ([DEV.ID.CATEG
- DEV.ID.AC.SUFX] or DEV.ID.INT.ACCT) becomes mandatory.
This field specifies the id of the ATM machine. The value should
not be duplicated in any other multi value set.
DEV.ID.CATEG 4 This field can input only if DEVICE.ID is not empty and
DEV.ID.INT.ACCT is empty
DEV.ID.AC.SUFX 4 This field can be input only if DEVICE.ID and DEV.ID.CATEG
are not empty and DEV.ID.INT.ACCT is empty
DEV.ID.INT.ACCT 16 This field can be input only if DEVICE.ID is not empty and
DEV.ID.CATEG is empty. It stores internal account.
Setup parameter in T24
Setup parameter in T24

ATM.BIN.ACCT

Stores the details like receivable and payable accounts for

network transactions (eg: visa/master). Important fields:

Field Name Len Description

ID 6 ID of file, it is bank identification number
DESCRIPTIOM 35 Description
PAY.ACCOUNT.NO 16 Payable Account Number
RECEIVE.ACCOUNT.NO 16 Receivable Account Number
Setup parameter in T24
Setup parameter in T24

AT.POS.MERCHANT.ACCT

Stores the merchant credit account number, ID is unique

merchant ID

Field Name Length Description

ID 6 Merchant ID
DESCRIPTIOM 35 Description
MERCHANT.ACCT.NO 16 Merchant credit account number
Setup parameter in T24
Setup parameter in T24

AT.POS.BIN.ACCT

Stores the details like receivable and payable accounts for

network transactions

Field Name Length Description

ID 6 ID of file, it is bank identification
number
DESCRIPTIOM 35 Description
POS.RECEIVE.ACCT 16 Receivable Account Number
POS.PAY.ACCT 16 Payable Account Number
COMMISSION.TYPE Commission type (if any)
Setup parameter in T24
WORKSHOP
Workshop

1. What will we do in T24 for a new ATM

machine?

2. What will we do in T24 for a new POS?

Workshop

Test
1. Telnet directly from your computer
Prepare ISO message
Telnet to port 4002 and paste message like below

Check log file: atm_monitor.log in [tcserver]/log

2. Test from ATM/POS, check log file

Question

QUESTION?