8/18/2019 Ebs_third Party Integration Manual
1/15
EBS THIRD PARTY INTEGRATION MANUAL
8/18/2019 Ebs_third Party Integration Manual
2/15
This manual has been prepared for reference of E-Billings Solutions Pvt Ltdhereafter referred as EBS. This manual is intended to be used by the EBS and itsemployees only to facilitate use of Payment Gateway. This manual has beenprepared on a best effort basis. espite every effort to avoid errors it is li!elythat some errors may creep in. The EBS may at its sole discretion modify" alter"delete" add or amend any of the contents of this manual without assigning anyreason or prior intimation to the #ustomer. $t is notified that the EBS shall not beresponsible for any damage or loss of action to anyone" of any !ind in anymanner arising by the use of this manual.
The contents of this manual are proprietary to the EBS and contain information
that is privileged and confidential. %se or dissemination of the contents of thismanual in any manner whatsoever is strictly prohibited. &o part of this manualmay be reproduced or copied in any form without the prior permission of theEBS. Breach of this condition shall be liable for legal action.
8/18/2019 Ebs_third Party Integration Manual
3/15
Contents
'.Third Party $ntegration Setup
(.Steps )or $ntegration
i* $nputs to EBS
ii* +esponse )rom EBS
,. Possibilities of Errors Solutions
1.THIRD PARTY INTEGRATION SETUP
$t allows a merchant to collect the payment option from their domain. EBS irect
$ntegration allows erchant to collect payment options from the payment page and to
pass on to EBS Secure Server. The main goal is to s!ip the payment option selection
page" which reduces a step in the payment process.
EBS identifies erchant by /ccount $" which is uni0ue four1five digit number provided
once signed with us. Both EBS /ccount $ and EBS Secret 2ey is viewable by login in
EBS erchant /dmin Panel" #lic! on /ccounts-3Settings. 4ou can login to erchant
/dmin Panel by 5https611secure.ebs.in7
&ote6 To reset the secret !ey merchant should send an Email to support8ebs.in
re0uesting to reset the secret !ey.
EBS irect $ntegration 2it can be implemented in two methods"
i* &ormal $ntegration 2its9P:P" /SP" ;B" /sp.&et"
8/18/2019 Ebs_third Party Integration Manual
4/15
NORMAL INTEGRATION KITS
To implement the Thi! p"t#$EMI %it po&e!'e( the "!!ition"l p""mete
)p"#ment*option+ h"s to ,e "!!e! on the p"#ment p"-e)p"# ile+ o o'
E/S inte-"tion iles.
+elevant integration files can be downloaded through
https611support.ebs.in1app1inde>.php?12nowledgebase1List1$nde>1'@1integration-!its
The following files will be provided"
".P"# p"-e 0 Pay file 9pay.html* is a sample file" from where you can get the
necessary information 9Billing Shipping etc..* from your customer1cardholders.
/lso" the page can customiAe at your end for your convenience based on your
website re0uirement platform.
,. RC20 This file has the algorithm" which is responsible for encryption and
decryption process.
&. Response P"-e 0 This is a sample code of your +esponse page. /fter the
transaction" response page is used to retrieve all the + parameter values.
+eturnurl parameter value points to the response file.
Note0 /ll the , pages are sample files" you can customiAe as per yourneed without affecting the flow.
SHOPPING CART KITS
+elevant shopping cart files can be downloaded through our support website onthe below lin!"
https611support.ebs.in1app1inde>.php?12nowledgebase1List1$nde>1C1shopping-cart-!its
/s in the above case" the additional parameter 9paymentoption* has to be
added on the corresponding payment file from where the other + parameter
https://support.ebs.in/app/index.php?/Knowledgebase/List/Index/10/integration-kitshttps://support.ebs.in/app/index.php?/Knowledgebase/List/Index/7/shopping-cart-kitshttps://support.ebs.in/app/index.php?/Knowledgebase/List/Index/7/shopping-cart-kitshttps://support.ebs.in/app/index.php?/Knowledgebase/List/Index/10/integration-kitshttps://support.ebs.in/app/index.php?/Knowledgebase/List/Index/7/shopping-cart-kitshttps://support.ebs.in/app/index.php?/Knowledgebase/List/Index/7/shopping-cart-kits
8/18/2019 Ebs_third Party Integration Manual
5/15
values9/ccount $" ode" +eturn %+L" Sale /mount" escription" +eference
&umber" Billing Shipping /ddress* are passed.
Note 0 The p"#ment ile 3ill ,e po4i!e! in !ieent NAME ,"se! on the
%it.
INTEGRATION PROCEDURE
$n this $ntegration" the payment option selection page can be integrated in your
merchant website wherein the customer can select the payment mode in your domain.
On inte-"tin- this %it in #o' en!(
i* )or &et Ban!ing payment options" the customer will be directly routed to the
corresponding Ban! %+L from your application.
ii* )or #/+ payment options" the customer will be directed to the EBS page to
enter the credentials and then the process will be the same as earlier. The
integration !it for the same has been attached.
5.INTEGRATION STEPS
Inputs
$nputs are the mandatory parameters which should be passed onto the EBS Secure
Server to process the Payment from the erchant Payment1#onfirmation page.
)ollowing table gives the parameter list" which should be passed from the payment
page6
Post %+L6 https611secure.ebs.in1pg1ma1sale1pay
https://secure.ebs.in/pg/ma/sale/payhttps://secure.ebs.in/pg/ma/sale/pay
8/18/2019 Ebs_third Party Integration Manual
6/15
Parameter Descri tion T e Min
account_id Your EBS Account ID Char 4
reference_noYour reference number towardsorder Char
1
amount Total Sale AmountDecima l
1
descri tion Detail descri tion of the sale Char
1
mode ode ! either TEST"#I$E Char
4
return_url
This is the url %ou want EBS toreturn bac& after transactionis successful' Char
1
name Cardholder (ame Char 1
Address Cardholder)s billin address Char 1cit Cardholder)s billin cit Char 1
state Cardholder)s billin state Char 1
countr Cardholder)s billin* countr%'+,
Char
,
postal_code Cardholder)s billin ostal code' Char 1
hone Cardholder)s billin hone' Char .
email Cardholder)s billin email' Char 1
ship_name Customer deli/er (ame Char 1
ship_address Customer deli/er address Char 1
ship_cit% Customer deli/er cit Char 1
ship_state Customer deli/er state Char 1
ship_countr%Customer deli/er% countr%'+,
Char
,
ship_postal_code Customer deli/er ostal code' Char 1
0a%ment_option 0a ment tion Char 4
secure_hashD. hash of all the parameterswith
Char
,2
i* /ll the above parameters are mandatory to be passed on the merchant pay
file.
ii* The below parameters can be passed as a hidden fields"
/ccount $" +eference &o" ode" +eturn%+L" /mount" secure :ash
8/18/2019 Ebs_third Party Integration Manual
7/15
6ollo3 the inst'&tions -i4en ,elo3(
'.2indly add an additional parameter with the variable name DpaymentoptionD on
your payment file along with the other + parameters 9/ccountid" ode" /mount"+eturn %+L "Billing Shipping $nformation etc..* in the EBS integration files.
(./ separate #ode has been assigned for each and every payment option mentioned
below to pass the corresponding values through the parameter 5paymentoption7.
)or E6- TEST P/4E&T ET:= F 3 5'@@'7
The Payment methods are
i* #redit
ii* ebit
iii* #ash
iv* &et Ban!ing
v* E$
,.Pass the separate code from your database =+ using an array function through
the added parameter DpaymentoptionD. So that the corresponding payment option
will be displayed on your website for the customer selection.
Similarly payment option codes will be listed below for the other payment methods"
8/18/2019 Ebs_third Party Integration Manual
8/15
Ho3 to m"%e " P"#ment
S&eenShot 6o S"mple P"#ment Metho! P"-e
S&een shot 7 E/S P"#ment P"-e On&e P"#ment metho! sele&te!
8/18/2019 Ebs_third Party Integration Manual
9/15
i* =nce the payment method selected on the merchant website" you will re-
directed to our EBS payment page.
)or E>6- $f customer choose 5;isa7 payment method on the merchant website" only the
corresponding selected option will be shown on our EBS payment page as figured in the
above screen shot.
ii* :ence" customer has to enter the card credentials to proceed for further
payment completion.
8/18/2019 Ebs_third Party Integration Manual
10/15
S&eenshots o s"mple EMI p"-e
8/18/2019 Ebs_third Party Integration Manual
11/15
S&een shot 7 E/S P"#ment P"-e On&e P"#ment metho! sele&te!
E809
$f customer choose 5, month E$1 month E$7 payment method on the merchant
website" only the corresponding selected option will be shown on our EBS payment
page as figured in the above screen shot.
8/18/2019 Ebs_third Party Integration Manual
12/15
Response 6om E/S 0
In this sample response pa*e3 %ou ha/e to pro/ide %our EBS secret &e%' The response *i/en bac& to thereturn 5#3 the parameters in the response are listed below' The response of the transaction is *i/en
bac& usin* 0ST method to the 5# pointed b% 5eturn5# parameter in the pa% pa*e'
nce the transaction completed3 the correspondin* status and details of the same will be *i/en bac& to the5# pointed b% 5eturn5# parameter' This response will be *i/en bac& in encr%pted format usin* EBSsecret &e%' The response has the followin* parameters!
$f the ResponseCo!e is H@H the transaction is successful.
$f the ResponseCo!e is not H@H the transaction has been declined or an error condition as detected" suchas the customer typed an invalid card number.
Re&ommen!e! 4"li!"tion in the esponse ile to "4oi! !'pli&"tion o e&o!s in #o' ,"&%en!
'* Pass your order id in the referenceno parameter and in response file" chec! whether erchant+ef&oand your order id matches.(* #hec! the amount of the order and the DamountD parameter in the response is e0ual
$f both the conditions results as true" insert order in your bac! end" which nullifies the duplications.
Is 6l"--e! 0
)lagged transactions are potentially ris!y transactions" which will be verified by our +is! team and up-
dated manually as authoriAed1canceled within (I hours.
$f re0uired" we may contact you to provide details1confirmation for the action to be ta!en for such ris!ypayments.
&ote 6 Please do not process1ship the product1service to the customer until the transaction is
approved1authoriAed and captured.
Is6l"--e! &"n h"4e t3o ,oole"n 4"l'es YES$NO
D4esD"indicates that the transaction is waiting for manual verification.
D&oD" indicates that it is authoriAed and ready for capture.
$f the transaction is successful9response codeF D@D* and if the $s)lagged is D&oD" then the service can beprovided immediately.
$f the transaction is successful9response code F D@D* and if the $s)lagged is D4esD" then the service for
the corresponding payment has to be !ept on hold until the manual verification is completed and author-iAed by EBS.
Session Time =ut6 - 'J minutes
8/18/2019 Ebs_third Party Integration Manual
13/15
Response Parameters
Parameter Description
5es onseCode5esponse Code which *i/es the status of the transaction' 678ero9 for success and for other /alue3 :ailed'
Is:la edIt can be either YES"(' YES denotes that its waitin* for manual a ro/al'
5es onseessa e 5es onse essa e which tells about the 5es onse Code
Billin Address Card;older Billin Address
Amount Sales Amount of the transaction
Billin CitCard;older Billin* Cit%
Billin Countr Card;older Billin Countr
DateCreated DateTime of the transaction
Billin Email Card;older Email Id
odeIn which mode the transaction has been completed' Either TEST"#I$E
Billin (ame Card;older Billin (ame
0a mentId ni ue 0a ment Id i/en for all the a ments b EBS
Billin 0hone Card;older Contact (umber
Billin 0ostalCode Card;older 0ostal Code
5eference(o 0ro/ided b erchant to identif the transaction
Deli/er Address Shi in Address
Deli/er Cit Shi in Cit
Deli/er Countr Shi in Countr
Deli/er (ame 0erson (ame to whom its shi ed
Deli/er 0ostalCode Shi in 0ostal Code
Deli/er State Shi in state
0a ment tion code 1661
TransactionId A ni ue Id i/en for identif in the transaction'
8/18/2019 Ebs_third Party Integration Manual
14/15
2.POSSI/ILITIES O6 ERROR : DESCRIPTIONS
$. Selected Payment =ption &ot activated" please try another option
$n order to avoid the above error message" !indly satisfy the below criteria"
i* Ensure that the registered /ccount $ value has been passed on the EBS payment file.
Since " the payment options will not be applicable on our EBS E= /ccount 9JKK@*.
&ote 6 To retrieve the registered /ccount details" log on to your EBS secure portal through
5secure.ebs.in7 and navigate to the tab /ccount - 3 Settings - 3 there you can find your
account details9 /ccount $ Secret 2ey*.
ii* The Payment option code value has to be passed through the parameter 5paymentoption7
only based on the corresponding PG9 />is" #iti" SB$" :)#*
iii* $f the selected payment method 9#redit1ebit1#ash1&et-Ban!ing1E$1PayPal* has not been
activated on the corresponding merchant account from EBS.
8/18/2019 Ebs_third Party Integration Manual
15/15
To ensure prompt support, EBS has a simple online ticketing system accessible
24x7 at http://support.ebs.in. Each ticket will be responded in to 24 Business
working !ours, with ticket number to "acilitate status check anytime therea"ter.
Please send your suggestions/ feedback to:
+91 44 4231 3333
http://support.ebs.in/mailto:[email protected]://support.ebs.in/mailto:[email protected]Top Related