EBS iNtegration Guide, Exercises of Information Integration

EBS iNtegration Guide for payment gateway integration

Typology: Exercises

2017/2018

Uploaded on 05/02/2018

grdixit65
grdixit65 🇮🇳

1 document

1 / 37

Toggle sidebar

This page cannot be seen from the preview

Don't miss anything!

bg1
EBS Integration Guide 3.0.1
© Copyright E-Billing Solutions Pvt Ltd.
Page 1
E Billing Solutions Pvt. Ltd.
EBS INTEGRATION GUIDE Version
3.0.1
pf3
pf4
pf5
pf8
pf9
pfa
pfd
pfe
pff
pf12
pf13
pf14
pf15
pf16
pf17
pf18
pf19
pf1a
pf1b
pf1c
pf1d
pf1e
pf1f
pf20
pf21
pf22
pf23
pf24
pf25

Partial preview of the text

Download EBS iNtegration Guide and more Exercises Information Integration in PDF only on Docsity!

© Copyright E-Billing Solutions Pvt Ltd.

E Billing Solutions Pvt. Ltd.

EBS INTEGRATION GUIDE Version

© Copyright E-Billing Solutions Pvt Ltd.

    1. INTRODUCTION Table of Contents
    1. PRE-REQUISITE
    1. ENVIRONMENT DETAILS
    1. SALE PROCESS FLOW
    1. INTERNAL STATUS FLOW
    1. MERCHANT WEBSITE INTEGRATION
  • APPENDIX A – SECURE HASH VALIDATION.............................................................
  • APPENDIX B – SETTLEMENT CYCLE
  • APPENDIX C – ISO3 COUNTRY NAME
  • APPENDIX D – PCI DSS COMPLIANCE.......................................................................

© Copyright E-Billing Solutions Pvt Ltd.

3. SALE PROCESS FLOW

  • Customer selects to check out on the Merchant Website.
  • Merchant Website will redirect the Customer to EBS Payment Page.
  • Customer Selects Payment Method (Credit Card, Debit Card, Net banking, Cash Card) and Payment option on the Merchant Website. If the Customer selects Credit or Debit cards, he will be asked to provide the credit card number or the debit card number

respectively.

© Copyright E-Billing Solutions Pvt Ltd.

  • Transaction is screened and Customer is redirected to respective Acquirer for processing.
  • Customer is redirected back to Merchant Website with the response.

4. INTERNAL STATUS FLOW

Status Details: I. Authorized Payments– Payments which are completed successfully

II. Flagged Payments – Payments which are completed are successfully and are

flagged by Fraud Screening System. Order will not be processed in this tate. These payments will be reviewed manually by EBS internal team and un-flagged or Cancel. III. Captured – Payments captured by the Merchant.

IV. Refund – Payments refunded by the Merchant to the Customer. V. Charge Back – Payments which are refunded forcefully by EBS for any

complaints raised by the Customer with the Card provider or Card Brands.

© Copyright E-Billing Solutions Pvt Ltd.

city Customer billing city char 1 32 YES

state Customer billing state char 1 32 NO

country Customer billing country. char 3 3 YES [3 Digit ISO3 country code- refer Appendix C] postal_code Customer billing postal char 1 10 YES code phone Customer billing phone char 5 20 YES email Customer billing email char 1 100 YES ship_name Customer delivery Name char 1 255 NO ship_address Customer delivery address char 1 255 NO ship_city Customer delivery city char 1 32 NO ship_state Customer delivery state char 1 32 NO ship_country Customer delivery char 3 3 NO country[3 Digit ISO country code- refer Appendix C] ship_postal_code Customer delivery postal char 1 10 NO code ship_phone Customer delivery phone char 5 20 NO bank_code Bank code provided by EBS char 1 5 NO name_on_card Name of the card holder. char 1 20 YES Only for Direct mode card_number Credit card number. Only numeric 13 19 YES for Direct mode card_expiry Expiry date of the credit numeric 4 4 YES card. [Format: MMYY] Only for Direct mode. payment_option Payment option code char 1 5 NO provided by EBS. Only for standard mode payment_mode Give 1 for Credit Card , 2 for numeric - - NO Debit Card,3 for Net Banking, 4 for Cash Card, 5 for Credit Card – EMI, 6 for Credit Card

© Copyright E-Billing Solutions Pvt Ltd.

card_brand (^) Give 1 for VISA, 2 for numeric - - NO MasterCard, 3 for Maestro, 4 for Diners Club, 5 for American Express and 6 for JCB

emi EMI period like 3, 6,9,12 char 1 2 NO etc. for Credit Card.

page_id The id of the customized char 1 2 NO page

card_cvv CVV number of the credit numeric 3 4 YES card. Only for Direct mode.

secure_hash Hash value calculated char 32 32 YES

© Copyright E-Billing Solutions Pvt Ltd.

<input name="name_on_card” type=”hidden” value=” XXXX” /> <input name=”card_number” type=”hidden” value=” XXXX”/> <input name="card_expiry” type=”hidden” value=” XXXX” /> <input name=”card_cvv” type=”hidden” value=” XXXX”/> <input name="emi” type=”hidden” value=” XXXX” /> <input name=”page_id” type=”hidden” value=” XXXX”/> <input name=”secure_hash” type=”hidden” value=” XXXX” />

© Copyright E-Billing Solutions Pvt Ltd.

iv. Sample HTML form For Standard Mode

The link between Merchant website and EBS Payment page has to be maintained on the last

page of the shopping basket on Merchant website.

Below are the parameters to be posted to EBS.

<input name="emi” type=”hidden” value=” XXXX” /> <input name=”page_id” type=”hidden” value=” XXXX”/> <input name=”secure_hash” type=”hidden” value=” XXXX” />

© Copyright E-Billing Solutions Pvt Ltd.

1.2 Adding a Page

You may add up to 5 pages from your account.

To add a page:

In the payment pages screen, select Create New Page button

Figure 1: Adding a Page

On clicking the Create New Page button, the following page will be displayed:

© Copyright E-Billing Solutions Pvt Ltd.

Here you can customize the page according to your preference

Figure 2: Changing page preferences

1.3 Payment Page Preferences

1.3.1 Payment Page Preferences - GENERAL

Page Name

The Page name will be used to refer to the page style within your EBS account payment pages link. This name will be displayed as the list pf payment pages on clicking the Payment Pages tab.

© Copyright E-Billing Solutions Pvt Ltd.

The secure hash algorithm is used to generate secure hash for request and response. You have to select any one of the method given. The parameters will be hashed according to the algorithm selected and sent together with the parameters.

Customer Information in Response

If Yes is selected, the customer information will also be sent along with the response.

HTTP Method for Response Data

On Selecting GET method, the response parameters will be sent back along with the return URL and it will be visible for all. But if POST method is selected, it won’t be visible to others.

Redirection Page

The redirection page while connecting EBS to bank would be visible to the customer if Show option is selected.

Success Page

If the payment is successful, the customer will be redirected to Success Page. This option decides whether you want this to happen or bypass the success page and directly go to Return URL.

Failure Page

Normally Failure Page will be shown once the transaction gets failed. It can be avoided by selecting Hide here.

Retry Option

Customer is given with the provision of 3 retries per order if the transaction gets failed. Select SHOW to make Retry link visible in the failure page.

Secure Seals

Merchant can choose to show or hide logos of the secure seals such as Verizon using this option.

Google Analytics Account

Enter your google analytics account number here to track payment pages.

1.3.2 Payment Page Preferences - PAYMENT OPTIONS PAGE

Other Currency

The approximate value of payment amount in this currency will be displayed additionally in the payment options page. You can select any of the currency from the dropdown.

© Copyright E-Billing Solutions Pvt Ltd.

Product Information

For displaying the Product Information in the payment page, select Show.

Collect Customer Information

Sometimes the customer information is required to be collected from the payment page. In that case, you can select Yes.

Customer Information

If it is not required to collect customer information from the payment page, but customer information needs to be displayed on the payment page, then select Show.

Payment modes tab Style

With this option, select payment modes tab style, to be either horizontal or vertical.

Go Back Button

If this button is to be shown on the payment page, select Show. On clicking this button, the customer will be redirected to your website.

Cancel Payment Button If the customer clicks this button, payment will get cancelled. Select Show or Hide. Select Payment Options which has to be hidden on the payment options page

Here, two sections are shown. The Available Payment Options block contains all the payment

options which are activated for the merchant. If you want to hide some of the payment options from the payment page, you can select the required payment option and click on the Hide button. It will be populated to the right side block and will not be displayed on the payment page. Later, if you want that payment option as well to be displayed on the payment

page, you can select that payment option and click on the Show button. It will be populated back to the Available Payment Options block.

1.3.3 Payment Page Preferences - LOOK & FEEL

Background Image

The background image for your payment page can be set as per your requirement. Maximum size of the image you can upload is 128 Kb. This image will be taken as background image for all the payment related pages like main payment page, redirection, success, failure etc.

Repeat Background Image

© Copyright E-Billing Solutions Pvt Ltd.

This color is to be used for the active tab in your payment page. Enter the color in HTML hex code using the color picker given.

Active Tab Text Color

The color is to be used for the text inside the active tab in your payment page. Enter the color in HTML hex code using the color picker given.

Button Background Color

The background color used for buttons inside the payment page is to be selected using this tab. Enter the color in HTML hex code using the color picker given.

Button Text Color

The color to be used for the text inside the buttons in your payment page is selected by this option. Enter the color in HTML hex code using the color picker given.

Button Border Color

This is the color to be used for the button borders in your payment page. Enter the color in HTML hex code using the color picker given.

Border Color

The color is used for all the borders in your payment page. Enter the color in the HTML hex code using the color picker given. Save/Cancel

After entering all your preferences, click Save to save it.

Now, you will be redirected to the list page where you can preview, edit and delete the pages created.

1.4 Previewing a Page

Figure 4: List of Created Payment Pages

© Copyright E-Billing Solutions Pvt Ltd.

To preview a page:

  • Select Payment Pages
  • Click the preview button at the right side of the page list.

Figure 5: Preview option

1.5 Setting a page as DEFAULT

If a page is set as default and if the page ID parameter is not sent with the payment parameters, this page will be taken as default.

To make a page as default:

  1. Begin at the Custom Payment Page Styles page (see “Getting Started,” above)
  2. Click the default button (red) under the heading default which you wish to make as default page.
  3. The color of the button will be changed to green once it is made default.

Figure 6: Setting as default option