Web Payment Integration Document - MinIO Browser

iPay Payment Gateway

Integration Document

Version 1.0

Table of Contents

1.

Introduction ............................................................................................................................ 2

2.

How iPay Payment Gateway Works........................................................................................ 2

3.

Prerequisites ........................................................................................................................... 3

4.

Getting Started........................................................................................................................ 3

5.

Setting up Development Environment ................................................................................... 5

5.1

Add Checkout HTML form to your website...................................................................... 5

5.2

Capture the Transaction................................................................................................... 7

5.3

Verifying Payment Status ................................................................................................. 8

6.

Card Payments Test Details .................................................................................................... 9

7.

Live Implementation ............................................................................................................. 10

Appendix ....................................................................................................................................... 11

1. Introduction

The usage of E-Commerce has increased exponentially in the recent past. The iPay Payment

Gateway solution looks to empower the growth of all businesses with a website by providing a

payment processing platform to ride the E-Commerce wave. The iPay Payment Gateway can be

integrated to your website easily with minimum technical effort by following the simple instructions

in this document. The successful integration to the iPay Payment Gateway will allow businesses to

accept payments from their customers via Payment Cards, via iPay and other LankaQR compliant apps

in the country.

This document will provide an easy to follow, step-by-step guide to the technical integration work

required to enable this feature to the merchant e-commerce website in the iPay Sandbox

environment. Upon successful integration in the Sandbox environment, the business will be required

to contact the iPay Merchant Management Team to complete the iPay merchant registration and

enable this product in the live environment. The steps followed in the Sandbox environment will

simply have to be replicated in the live environment after successful registration.

2. How iPay Payment Gateway Works

iPay provides HTML form-based POST API to integrate iPay with your website. You can initiate a

payment request by submitting required information to that API from your website and it will redirect

your customer to the iPay Payment Gateway interface.

Customers can initiate payments by selecting any payment source offered by the merchant &

providing the required details for the selected payment source.

1. Payment Card ¨C Enter & submit required card details such as Name, Card Number, CVV, and

Expiry Date to verify the details.

2. Lanka QR - Scan the LankaQR code and make the payment by any LankaQR compliant mobile

application.

3. iPay - Enter user mobile number & email address as account information & then the user will

receive a push notification to iPay in order to authenticate the payment.

Once the payment is processed, iPay notifies your call-back API about the payment status as a

server callback. Here, iPay generates a checksum and sends it with response parameters to ensure

integrity and you can use those response parameters & checksum to verify and update your system

accordingly.

iPay Payment Gateway - Integration Document - Version 1.0

3. Prerequisites

1. You as the web merchant should have your own custom e-commerce web application as you need

code level integration.

2. You as the web merchant should register as a Merchant in the iPay Sandbox by providing the

required information to obtain the Web payment token.

3. You should have the iPay sandbox mobile application or any other Lanka QR compliant payment

application connected with the Lanka Pay sandbox. (You can download the iPay sandbox mobile

application from the Admin Portal after registration)

4. Getting Started

1. Go to the iPay Sandbox website using the following URL.

Sandbox:

2. Register as a merchant and log in to the Sandbox Merchant admin portal by using the username

and password approved at registration.

3. Go to the ¡°Merchant Settings¡± option on the user side menu and click on ¡°Development

Settings¡±.

Then the page will display the screen shown below. Enable Development Settings by clicking on

the checkbox shown below.

iPay Payment Gateway - Integration Document - Version 1.0

4. After enabling the merchant for development, the ¡°Developer Portal¡± will automatically display on

the user side menu as shown below. Then select the ¡°Payment Integration¡± ¡°IPG Payments¡± option

and generate an IPG integration token by providing the required details.

Then Merchant should provide value for the ¡°Secret¡± option and this secret is used to generate the

Checksum.

Merchant should provide a ¡°Call back API URL¡± and this will be used to notify the Payment Status.

Note: This IP address or domain based HTTPS URL must be publicly accessible.

5. Select the payment schemes you want to enable for your website.

6. Enable Additional Security (Optional) ¨C Merchant can enable additional security for the checkout

HTML form to ensure the integrity of Order ID and Transaction Amount. Here, the Merchant needs to

generate a checksum using the below given combination of parameters and send it to the checkout

HTML form.

Message = IPG Integration Token + Order ID + Transaction Amount

NOTE: Please refer to Section 5.3 for additional information on checksum generation

7. The IPG Integration Token will be automatically generated when clicked on the ¡°Generate Token¡±

button which will be specific for the merchant. The merchant should use this IPG Integration Token

when setting up iPay Payment checkout API.

iPay Payment Gateway - Integration Document - Version 1.0

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download