EASYTRIP SERVICES CORPORATION

ESC SYSTEM PROJECT

Easytrip Services Corp.

Head Office : Unit 701,
Citystate Centre, 709 Shaw Bd.,
Pasig City 1603
Philippines
TEL : + (632) 635 34 40
FAX : + (632) 638 89 20

ESC WEB SERVICE

FUNCTIONAL SPECIFICATIONS
(ESC-MEPS INTERFACE DOCUMENT)

VERSION 2.0

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

REVISIONS
VERSION
DATE
1.0
January 23,2014 Frederick Silva
2.0
May 14, 2014
Frederick Silva

DESIGNATION

VALIDATION
Written by :

Date :

Signature :

Date :

Signature :

Red Silva
Authorised by:
Lito Sabino

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

TABLE OF CONTENTS
TABLE OF CONTENTS.............................................................................................................................................1
INTRODUCTION........................................................................................................................................................2
ESC SMS/POS WEB SERVICE OVERVIEW.........................................................................................................3
THE ESC SMS WEB SERVICE FUNCTIONALITIES..........................................................................................5

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

Introduction
The ESC Web Service is software application that will serve as a link between the AMS of ESC
and MEPS system:
ESC Web Service major functionalities will be to:
- Receive request in XML format from MEPS.
- Send response in XML format to MEPS.
This document gives the Functional Specifications of the ESC Web Service.

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

ESC SMS/POS Web Service Overview

1.1. FUNCTIONAL SCOPE OVERVIEW
The application shall provide the following:

Web service allowing MEPS to send a request/message in the form of XML for the
following processes:
o Customer Verification.
o Customer Reload.

Web service that will send a response in the form of XML to MEPS for the following
processes:
o Response to customer verification.
o Response to customer reloads.

1.2. SYSTEM ARCHITECTURE

The ESC web service is a standard web protocol (XML). It shall be hosted by the AMS web
server.
1.3. USER LEVELS
XML has a Login and password element, this is verified by the web service to ensure a valid
request.
1.4. ACCESS
The application shall be accessible via its public IP web address.

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

1.5. PROGRAMMING GUIDELINES

The application shall be developed taking into consideration maximum security, robustness and
swiftness. The code shall be clearly commented.

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

The ESC SMS Web Service Functionalities

1.6. RECEIVE REQUEST FROM MEPS HOST EQUIPMENT.
1.6.1. CUSTOMER VERIFICATION
MEPS shall provide the following XML to ESC web service.
The XML mandatory element to be filled-up shall be:
o Login
o Password
o Key1 First key word
o Key2 Second key word
o AccountNo - Customer Account No.
After parsing the XML, the web service would verify if the login and password is valid.
If valid, ESC web service will determine the keywords used in the XML. For this transaction the
keywords to be used are ESC for Key1 and VAL for Key2. The ESC web service checks the
Account No if existing and store result to XML to be sent to MEPS.
1.6.2. RECEIVED CUSTOMER RELOAD THRU MEPS HOST EQUIPMENT
The XML Mandatory elements to be filled-up shall be:
o
o
o
o
o
o
o
o
o

Login
Password
Key1 First key word
Key2 Second key word
Amount Reloaded amount by the customer
AccountNo Customer Account No.
BranchCode Assigned by ESC to MEPS
TransCode Transaction ID of MEPS Reload.
TransDate Transaction Date from Kiosk Machine

After parsing the XML, the web service would verify if the login and password is valid. If valid,
ESC web service will determine the keywords used in the XML. For this transaction the
keywords to be used are ESC for Key1 and REL for Key2. The ESC web service will credit
the corresponding reload amount to customers account. The transaction is saved on AMS
database for future reference.

ESC System Project

ESC MEPS FS

ESC-MEPS FS.Doc

Version 1.0 23/01/14

1.7. SEND RESPONSE TO MEPS HOST EQUIPMENT

Message is sent to MEPS Host Equipment by ESC web services in the form of XML.
1.7.1. SEND RESPONSE ON CUSTOMER VERIFICATION.
After receiving the customers request thru ESC web service, the ESC web service shall
automatically check existence of account on our database using the Account No. as reference.
After the retrieved data have been converted to XML, the ESC web services will automatically
send this information to MEPS host equipment.
The XML mandatory element to be filled-up shall be:
o Process Y account exists, N account does not exist.
o EasytripMsg if Process Y = Account Balance, N = Account does not exist
1.7.2. SEND RESPONSE ON CUSTOMER RELOAD THRU MEPS HOST EQUIPMENT
After receiving the customers request thru ESC web service, the ESC web service shall
automatically process the requested data on our database using the Account No. as reference.
After the processing the request, the web service will automatically create message reply via
XML format, the ESC web services will automatically send this information to MEPS host
equipment.
The XML mandatory element to be filled-up shall be:
o
o
o
o

Process = Y account exists, N account does not exist.

EasytripMsg if Process Y = Account Balance, N = Account does not exist
TransactionCode Transaction Number from ESC.
TransactionDate - Transaction Date and Time (yyyymmddhhmmss)

If the System found that the Transaction Number already exist the ESC web services will
automatically send this information to MEPS host equipment.
The XML mandatory element to be filled-up shall be:
o Process = N Reload information already exist.
o EasytripMsg = Transaction Number already Exist.