You are on page 1of 4

Technical Documentation for Payment Gateway Integration

https://viewer.zoho.com/gettempcontent.do?genurl=eb1...

TechProcess Solutions Ltd.

Business Solutions

Document Id: BS-02-FR-03 Classification: Internal

Technical Documentation for Payment Gateway Integration

Type 1:

Bank Selection At TPSL web server

The purpose of this document is give the sub merchant the technical aspects about integration with Payment Gateway.

The Sub merchant should congure the front end the same way described below.

All the requests from the sub merchant to Payment Gateway should hit the URL

https://www.tpsl-india.in/PaymentGateway/CheckGatewayEnter.jsp

with the parameters mentioned below

Description Sr. No 1 2 3 4 5 Parameter Name SRCSITEID CRN AMT ITC PRN Sub merchant Id generated by TPSL to identify a sub merchant in TPSL database. Currency Used (by default INR) Sub merchant Transaction Amount. Extra information/parameters required by sub merchant can be passed in ITC parameter. Payment Reference number (Unique transaction Id generated by Sub merchant for every single transaction)

The sub merchant is not appreciated to send more than these ve parameters specied above.

The SRCSITEID will be given by TPSL for each sub merchant. If the sub merchants want to pass any extra parameters can be passed to TPSL by concatenating them as a single parameter and pass it in ITC parameter. The sub merchant is restricted to use the following symbols for concatenating the extra parameters

1 of 4

Friday 16 September 2011 05:49 PM

Technical Documentation for Payment Gateway Integration

https://viewer.zoho.com/gettempcontent.do?genurl=eb1...

~ Tilde - Hyphen = Equal To ? Question Mark % Percentage & Ampersand

Accepted Symbols

> (greater than) < (less than) ^ (raise to) $ (dollar) # (hash) _ (underscore) , (coma) ! (Exclamation) : (Colon) These variables can be passed through hidden variables or using query String. Hidden variable are most appreciable since that is more secure than query string.

The requests from valid sub merchants and urls are entertained.

Sample code in jsp to send the parameters using hidden variables

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <title>Untitled Document</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> </head>

<% response.setHeader("Cache-Control","no-store"); response.setHeader("Pragma","no-cache"); response.setDateHeader ("Expires", 0);

String SRCSITEID="T300"; String CRN="INR"; String AMT="1"; String ITC="Item_code"; String PRN="12345";

2 of 4

Friday 16 September 2011 05:49 PM

Technical Documentation for Payment Gateway Integration

https://viewer.zoho.com/gettempcontent.do?genurl=eb1...

%> <BODY> <FORM name="frm" action="https://www.tpsl-india.in/PaymentGateway/CheckGatewayEnter.jsp" method="POST"> <table align="Left"> <tr> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> <font><b><input type="hidden" name="SRCSITEID" value="<%=SRCSITEID%>"> </b></font></td> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> <font><b><input type="hidden" name="CRN" value="<%=CRN%>"> </b></font></td> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> <font><b><input type="hidden" name="AMT" value="<%=AMT%>"> </b></font></td> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> <font><b><input type="hidden" name="ITC" value="<%=ITC%>"> </b></font></td> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> <font><b><input type="hidden" name="PRN" value="<%=PRN%>"> </b></font></td> <TD colspan="3" VALIGN="TOP" ALIGN="center" class="error"> </td> </tr> </table> </form> </BODY> </HTML>

Sample Code in jsp to send the parameters using query String

<%

if(request.getParameter("btn_pay") !=null) {

response.sendRedirect("https://www.tpsl-india.in/PaymentGateway/CheckGatewayEnter.jsp?SRCSITEID=T300& CRN=INR&AMT=1&ITC=Item_Code&PRN=78688");

%> <html> <body> <form name="form1" method="post" action="Same.jsp"> <input type="submit" name="btn_pay" value="OK" >

3 of 4

Friday 16 September 2011 05:49 PM

Technical Documentation for Payment Gateway Integration

https://viewer.zoho.com/gettempcontent.do?genurl=eb1...

</form> </body> </html>

Conrming the output parameters

After the request send to the TPSL the sub merchant is updated with the below parameters

Description Sr. No 1 2 CRN PRN Parameter Name Currency Used (by default INR) Payment Reference number (Unique transaction Id generated by Sub merchant for every single transaction) Extra information/parameters required by sub merchant can be passed in ITC parameter. Sub merchant Transaction Amount. Bank Name, is the bank selected by the customer in TPSL site. (Y/N) Y indicates Success Transaction and N indicate Failed transaction. TPSL Transaction Id (Payment Reference Number in the TPSL Side)

3 4 5 6 7

ITC AMT Bank PAID BID

These parameters are send to the return url specied by the sub merchant. The Sub merchant has to congure the page to get these parameters.

Document_Name.doc Issued By: Sonali Awad Date: 4-June-08

Version 1.0 Reviewed By: Yogesh Z Date: 4-June-08

Page 1 of 4 Approved By: Yogesh Z Date : 4-June-08

4 of 4

Friday 16 September 2011 05:49 PM

You might also like