Ebs Integration Guide 3.0.1
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 37
| Download | |
| Open PDF In Browser | View PDF |
E Billing Solutions Pvt. Ltd. EBS Integration Guide 3.0.1 EBS INTEGRATION GUIDE Version 3.0.1 © Copyright E-Billing Solutions Pvt Ltd. Page 1 EBS Integration Guide 3.0.1 Table of Contents 1. INTRODUCTION .............................................................................................................. 3 2. PRE-REQUISITE ............................................................................................................. 3 3. ENVIRONMENT DETAILS ............................................................................................. 3 3. SALE PROCESS FLOW ................................................................................................. 4 4. INTERNAL STATUS FLOW ........................................................................................... 5 5. MERCHANT WEBSITE INTEGRATION ...................................................................... 6 APPENDIX A – SECURE HASH VALIDATION............................................................. 15 APPENDIX B – SETTLEMENT CYCLE ......................................................................... 16 APPENDIX C – ISO3 COUNTRY NAME ....................................................................... 18 APPENDIX D – PCI DSS COMPLIANCE....................................................................... 21 © Copyright E-Billing Solutions Pvt Ltd. Page 2 EBS Integration Guide 3.0.1 1. INTRODUCTION This document works as a guide for Merchants on understanding the EBS payment gateway Integration. This integration will allow the Merchant to have the Payment option Selection. This integration will also allow Credit card details to be captured on the Merchant website itself, on meeting the following pre-requisites. 2. PRE-REQUISITE For capturing Credit card details on the Merchant website, the Merchant application should be in compliance to PCI DSS. For more details on PCI DSS, please refer APPENDIX D. EBS should enable the Option for Merchant to capture Credit card data. 3. ENVIRONMENT DETAILS Test card details that can be used for testing purpose are as below VISA - 4111111111111111 - 07/16(Exp.) - 123(CVV) Card Holder Name: Test, Issuing Bank - Test Please Note: No other card number will be supported in test phase. i. Payment Request URL: Production – https://secure.ebs.in/pg/ma/payment/request ii. Integration Kit Kindly browse the following link to download Integration Kit/Shopping carts. http://support .ebs.in/index.php? _m=downloads&_a=view © Copyright E-Billing Solutions Pvt Ltd. Page 3 EBS Integration Guide 3.0.1 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. Page 4 EBS Integration Guide 3.0.1 • 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. Page 5 EBS Integration Guide 3.0.1 5. MERCHANT WEBSITE INTEGRATION i. Integration Mode There are two modes that are provided by the gateway: Standard mode: In this mode, all the payment details would be collected in the EBS payment page for payment transaction. Direct mode: In this mode, payment card details would be collected in the merchant website and redirected to the appropriate issuing bank to complete the transaction. In case of net banking using this mode, the merchant should set the channel value to “0” and pass the payment option parameter to EBS. ii. Request Parameter Details Parameter Description channel Type Min Max Mandatory The payment channel. numeric Give ‘0’ for Standard or ‘2’ for Direct Mode 1 1 YES account_id Your Account ID numeric - - YES reference_no Your Reference Number char 1 20 YES amount Total Sale Amount decimal 1 14,2 YES mode Mode of the LIVE => live, TEST => test char LIVE or LIVE or TEST TEST YES currency Currency INR Char 3 3 YES description Detail description of the sale char 1 255 YES return_url This is the url you want EBS to return back after transaction is successful char 1 255 YES name Customer billing Name char 1 128 YES address Customer billing address char 1 255 YES © Copyright E-Billing Solutions Pvt Ltd. Page 6 EBS Integration Guide 3.0.1 city Customer billing city char 1 32 YES state Customer billing state char 1 32 NO Customer billing country. [3 Digit ISO3 country coderefer Appendix C] Customer billing postal code char 3 3 YES char 1 10 YES 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 country[3 Digit ISO3 country code- refer Appendix C] Customer delivery postal code char 3 3 NO char 1 10 NO 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 numeric 13 19 YES numeric 4 4 YES country postal_code ship_postal_code Only for Direct mode card_number Credit card number. Only for Direct mode card_expiry Expiry date of the credit card. [Format: MMYY] Only for Direct mode. payment_option Payment option code provided by EBS. Only for standard mode char 1 5 NO payment_mode Give 1 for Credit Card , 2 for Debit Card,3 for Net Banking, 4 for Cash Card, 5 for Credit Card – EMI, 6 for Credit Card numeric - - NO © Copyright E-Billing Solutions Pvt Ltd. Page 7 EBS Integration Guide 3.0.1 card_brand Give 1 for VISA, 2 for MasterCard, 3 for Maestro, 4 for Diners Club, 5 for American Express and 6 for numeric - - NO char 1 2 NO char 1 2 NO numeric 3 4 YES char 32 32 YES JCB emi EMI period like 3, 6,9,12 etc. for Credit Card. page_id The id of the customized page card_cvv CVV number of the credit card. Only for Direct mode. secure_hash Hash value calculated © Copyright E-Billing Solutions Pvt Ltd. Page 8 EBS Integration Guide 3.0.1 iii. Sample HTML form For Direct 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.