Ebs_third Party Integration Manual

8/18/2019 Ebs_third Party Integration Manual

1/15

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.


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"


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


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


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


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/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!


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.


10/15

S&eenshots o s"mple EMI p"-e


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.


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


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'


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.


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:

[email protected]

+91 44 4231 3333
http://support.ebs.in/mailto:[email protected]://support.ebs.in/mailto:[email protected]

Ebs_third Party Integration Manual

Documents

Transcript of Ebs_third Party Integration Manual