JENGA PGW USER GUIDE FOR

DEVELOPERS

Version 3.0

Date: 31.03.2021

Owner: Finserve Ltd

CONFIDENTIALITY DISCLAIMER

THIS DOCUMENT AND THE INFORMATION IN IT ARE PROVIDED IN CONFIDENCE, FOR THE SOLE
PURPOSE OF EQUITY BANK LIMITEDAND MAY NOT BE DISCLOSED TO ANY THIRD PARTY OR USED FOR
ANY OTHER PURPOSE WITHOUT THE EXPRESS WRITTEN PERMISSION OF EQUITY BANK LIMITED.

Any form of reproduction, dissemination, copying, disclosure, modification, distribution and or publication of this material
is strictly prohibited. The contents of this document have not been independently verified and they do not purport to be
comprehensive, or to contain all the information that a prospective investor may need. No representation, warranty or
undertaking, expressed or implied is or will be made or given and no responsibility

1|Page Jenga V3 User Guide

Document Revisions

Date Version Number Document Changes

31-03-2021 1.0 Initial draft

2|Page Jenga V3 User Guide

Table of Contents
1. PREFACE ............................................................................................................................................ 4
Technical Data ........................................................................................................................................... 5
2. Getting Started ................................................................................................................................. 6
3. Integration Process ........................................................................................................................... 7
Request Parameters................................................................................................................................... 7
Sample Request.......................................................................................................................................... 8
5. RELATED DOCUMENTATION ........................................................................................................... 10

3|Page Jenga V3 User Guide

 1. PREFACE
Finserve Payment Gateway (PGW) is a solution that offers e-commerce Merchants and their
customers a secure mode of payment through various payment channels.

The PGW functions by aggregating different digital payment channels available in the market to
provide a single interface to users. It facilitates payments by transferring information between a
checkout page and Equity Bank which is the acquiring Bank. It is hosted in the cloud and
merchants integrate it with their websites by calling the specified URL with the required
parameters. The checkout page launches as a new page redirected from the merchant's website
once the required integration process is complete.

Supported channels:

• Equitel
• Mpesa
• Airtel Money
• Cards.

4|Page Jenga V3 User Guide

Technical Data

Parameter Unit
API Application Programming Interface

PGW Payment Gateway

5|Page Jenga V3 Admin User Guide

 2. Getting Started
To use the payment gateway, you need to be registered

1. Self-onboarding on Finserve Africa

a. Go to https://v3.jengahq.io/
b. Create an account:
i. Provide your details, click register and wait for a confirmation email
ii. Click on the link on your email to confirm your account.
iii. Login and proceed to activate your account by clicking the switch to live toggle.
Fill in the Contact info, Business details, Signatory details and Upload required
documents. Click on submit and wait for your account to be approved.
iv. Proceed to the settings and do some setup. It will only take a few minutes. Add
an account, add wallet, select the services you want to consume (e.g. MPESA,
Equitel, Visa). Kindly note an account or wallet is required for successful
subscription. You can come back and subscribe to more services later.
c. After successful creation and activation, you should note the below:
i. Merchant code (Sample: 9397187322), top left corner once logged in.
ii. Ensure the account details under your profile are correct
d. Generate a token using the auth API
e. You are now ready for the next step.

6|Page Jenga V3 Admin User Guide

 3. Integration Process

Request Parameters

Below are the parameters required to integrate. You will pass them to the process url provided
which will redirect to the Jenga Checkout page. After successful payment or failure you will be
redirected to the callback url provided in the request.

Parameter Meaning Sample Mandatory?

token Token generated YES

via auth API

merchantCode The merchant code YES

provided at
registration.

wallet The wallet to be YES

used for the
transaction

orderAmount The value of the YES

transaction.

orderReference The merchant YES

order reference.

• Min 8
characters
• It has to be
alphanumer
ic

productType Product category YES

7|Page Jenga V3 Admin User Guide

productDescription A brief summary of YES
the product. max
200 characters

extraData This data will be YES

echoed back during
callback url

paymentTimeLimit Duration payment YES

is valid

customerFirstName The customer's YES

First Name

customerLastName The customer's Last YES

Name

customerPostalCod Customer’s postal YES

eZip code

customerAddress Customer’s address YES

callbackUrl Merchant callback YES

url

Sample Request

<form id="submitcheckout" action=" https://payment-gateway-

v3.azurewebsites.net/processPayment " method="POST">
<input type="hidden" id="token" name="token">
<input type="hidden" id="merchantCode" name="merchantCode">
<input type="hidden" id="wallet" name="wallet">

8|Page Jenga V3 Admin User Guide

 <input type="hidden" id="orderAmount" name="orderAmount">
<input type="hidden" id="orderReference" name="orderReference">
<input type="hidden" id="productType" name="productType">
<input type="hidden" id="productDescription" name="productDescription">
<input type="hidden" id=" paymentTimeLimit " name=" paymentTimeLimit ">
<input type="hidden" id="customerFirstName" name="customerFirstName">
<input type="hidden" id="customerLastName" name="customerLastName">
<input type="hidden" id="customerPostalCodeZip" name=" customerPostalCodeZip ">
<input type="hidden" id="customerAddress" name=" customerAddress ">
<input type="hidden" id="extraData" name="extraData">
<input type="hidden" id="callbackUrl" name="callbackUrl">
</form>

9|Page Jenga V3 Admin User Guide

5. RELATED DOCUMENTATION

# Document Title Version # Location Author

10 | P a g e Jenga V3 Admin User Guide