This document is prepared to provide information about integrating merchant portal with Payment
Gateway using REST API.
Purpose of the Document
The Payment Gateway follows industry standards and norms as prescribed by Payment Schemes
(MasterCard, Visa International etc.) as well in conformity with Payment Card Industry – Data Security
Standards commonly referred to as PCI – DSS.
The expectation being that the merchant’s system integrator or auditor can refer to a document while
performing integration as well as post integration. It contains the technical integration details including
message formats to be used in communicating to the Payment Gateway irrespective of the merchant
platform being used. The document also shares the best practices and recommendations the merchant
should follow during the integration with Payment Gateway.
Target Audience
This document is intended for Project managers, Developers, and Testers.
Conventions Used
The following table lists the conventions that are used in this book:
| Version No. | Reason for Change | Created or Updated On |
| 1.0 | Merchant integration using REST API | Jul 22, 2023 |
| 1.1 | Updated as per comments | Jul 25, 2023 |
| 1.2 | Updated as per comments | Jul 29, 2023 |
Merchant Pre-requisites
Describes the pre-requisites for the Merchant. Readers of this user guide should be familiar
with basic either of the languages JSP and Java.
Hardware Pre-requisites
Merchants can use their existing hardware for transaction processing via Payment Gateway. Merchants
may have a variety of arrangements for hosting their websites and thus have relevant security mandates
for internet access controls and checks.
This may include utilization of a Proxy Server which presents
informed challenges. It is recommended that the merchant use a Public IP during the integration testing
for transaction processing to the Payment Gateway. The merchant should ensure the Payment Gateway
Domain and IP address is enabled at the firewall for both incoming and outgoing request/response.
Software Prerequisites
The merchant should have the requisite software for connecting to the Payment Gateway depending on
the merchant application environment. The merchant may use combinations of OS/Web Server/
Application server whilst setting up and operating the website. Standard Software options are listed
below, this list is for reference use only Operating Systems – Windows 2000/ 2003 / 2008 Server, Linux, Sun Solaris, IBM AIX Web/Application
Servers – The current version with all required patches is recommended to ensure success. Software
Installation – Basic software that are required for Web/Application server should be installed at the
merchant site.