USER GUIDE (MERCHANT)

MOBILE MONEY ONLINE

PLATFORM

Project number: PRMTN160104

 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Table of Contents

1. MERCHANT ACCOUNT CREATION ...................................................................................... 1

1.1. Individual Merchant Account ............................................................................................. 1
1.1.1. Individual Merchant with Mobile Money Account .......................................................... 1
1.1.1. Individual Merchant with a Mobile Money Account ....................................................... 2
1.2. Corporate Merchant Account ............................................................................................. 3

2. AUTHENTICATION MANAGEMENT ....................................................................................... 4

2.1. Log in .................................................................................................................................... 4
2.2. Log out.................................................................................................................................. 4
2.3. Forgot Password ................................................................................................................. 5
1.1. Hide menu bar...................................................................................................................... 6
1.2. Display of the home ............................................................................................................ 6
1.3. Change of language ............................................................................................................ 6
1.4. Update profile ...................................................................................................................... 7

3. VIEW REPORTS ....................................................................................................................... 8

4. BUTTONS MANAGEMENT ..................................................................................................... 9

4.1. View source .......................................................................................................................... 9
4.2. Button source code ........................................................................................................... 10
4.3. Copy source code ............................................................................................................. 10
4.4. Insert the source code to the merchant page ................................................................ 10
4.5. Change the defaults values of the button by the corrects values ............................... 11
4.6. Display button .................................................................................................................... 12
4.7. Transaction Result ............................................................................................................ 13
4.8. CodeLess Code ................................................................................................................. 13
1.4.1. For the RequestPayement and Donate CodeLess Code ........................................... 13

i
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

List of Figures

Figure 1. Create account page ..................................................................................................... 1

Figure 2. Select the type of merchant .......................................................................................... 2

Figure 3. Create individual an user account ................................................................................. 2

Figure 4. Create individual user account form without mobile money account ........................... 3

Figure 5. Select Merchant type Corporate ................................................................................... 3

Figure 6. Create enterprise user account form............................................................................. 3

Figure 7. Authentication page....................................................................................................... 4

Figure 8. Sign out view button ...................................................................................................... 5

Figure 9. “I forgot my password” button ....................................................................................... 5

Figure 10. Enter the email address............................................................................................. 5

Figure 11. Hide menu bar ........................................................................................................... 6

Figure 12. Icon of the home page ............................................................................................... 6

Figure 13. Change language ...................................................................................................... 7

Figure 14. Update profil .............................................................................................................. 7

Figure 15. Reports buttons ......................................................................................................... 8

Figure 16. View report................................................................................................................. 8

Figure 17. Merchant Dashboard ................................................................................................. 9

Figure 18. Button management screen ...................................................................................... 9

Figure 19. Button source code to be copied ............................................................................. 10

Figure 20. Button source code copied ...................................................................................... 10

Figure 21. Button source on an HTML editor ........................................................................... 11

Figure 22. Merchant web site example ..................................................................................... 12

ii
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Revisions

Version Date Author(s) Description

1.0 2016/02/17 Franck HAPPI Create document

1.1 2016/03/09 Franck HAPPI Update document

1.2 2016/03/15 Franck NGADENE Update document

1.3 2016/06/17 Rachida BOUBA Update document

1.4 2016/07/01 Rachida BOUBA Update document

1.5 2016/07/15 Jean Claude MBENG Update document

1.6 2016/11/30 Jean Claude MBENG Update document

1.7 2016/12/09 Eric James NKOUANKAM Proofreading and Diffusion

iii
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

1. Merchant Account Creation

1.1. Individual Merchant Account

1.1.1. Individual Merchant with Mobile Money Account

To create an individual merchant with a mobile money account, user have to make tasks below:

 User has to click on “Create my account” button

 User has to click on “Individual Merchant” button
 Then he has to fill the form and submit it

Figure 1. Create account page

1
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Figure 2. Select the type of merchant

Figure 3. Create individual an user account

1.1.1. Individual Merchant with a Mobile Money Account

To create an individual merchant mobile money account, the user have to complete the followings
tasks:

 Fill the form with he require information

 All the information’s are mandatory
 After he has filled the user submit the form

A message will be sent to the merchant in his mail box with his credentials

2
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Figure 4. Create individual user account form without mobile money account

1.2. Corporate Merchant Account

To create a corporate merchant account, user have to make tasks below:

 User has to click on “Corporate Merchant” button

 Then he has to download Contract templates, Mobile Money registration form and list of
requirements document.
 After download them he has to fill the Mobile Money form and Contract templates, scan
them and upload them with equally needed files
 Next fill the form and submit it

Figure 5. Select Merchant type Corporate

Figure 6. Create enterprise user account form

3
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

2. Authentication Management

2.1. Log in
To be connected, the user should be on platform, and then enter his credentials (Email, Password).

Figure 7. Authentication page

2.2. Log out

To be disconnected, user has to first click on the button that has his email address in right top
corner. After that he click on button <Sign out>

4
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Figure 8. Sign out view button

2.3. Forgot Password

Click on “I forgot my password” to get a new password,

Figure 9. “I forgot my password” button

Enter the email address of receipt of the link allows to change the password

Figure 10. Enter the email address

5
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

1.1. Hide menu bar

This icon will hide the menu bar

Figure 11. Hide menu bar

1.2. Display of the home

Click on this icon to display the home page:

Figure 12. Icon of the home page

1.3. Change of language

To change the language from the home interface, simply place the field as shown:

6
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Figure 13. Change language

1.4. Update profile

The modification of the profile once connected is done as follows:

Figure 14. Update profil

7
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

3. View Reports
To view a report, Merchant has to click on the button of the report, then the system will display the
report. The report has data of the current day. The admin will select an interval and click on “Search”
button to reload the report.

Figure 15. Reports buttons

The following element (1 of 1) indicates that we are on the page and that it is a single. For period
selected on the screen no report is available.

Figure 16. View report

8
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

4. Buttons Management
Once the user is logged on MOMO platform by clicking on the sign in button, it accesses its
administration page clicks the button buttons Management

Figure 17. Merchant Dashboard

4.1. View source

The buttons management page provides different types of buttons defined in the platform; button
after selecting the type, the user clicks the button display the source code

Figure 18. Button management screen

9
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

4.2. Button source code

Viewing the source code opens a modal window containing the source code of the page

Figure 19. Button source code to be copied

4.3. Copy source code

The source code of the selected button is displayed with a button to copy the source code to
paste into a merchant site code portion

Figure 20. Button source code copied

4.4. Insert the source code to the merchant page

Once copied the source code, open the page that will contain the transaction MOMO button and
paste the previously copied source code on the platform

10
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

Figure 21. Button source on an HTML editor

4.5. Change the defaults values of the button by the

corrects values
Only two values have to be change in the button’s code

1- The amount of transaction :

This value is needed for both Payment operation and Refund operation. The value can be changed
as explain below

<input name="_amount" value="0" id="montant" autocomplete="off" type="text" />

In the button code the merchant website’s developer will changed the red 0 by the true amount of
the transaction

In the button code the merchant website’s developer will changed the red number 6700500800
by the true phone number which will request the transaction

<input name="_tel" autocomplete="off" type="hidden" value="6700500800" />

The value of amount should be automatically fiilled by the merchant website’s depending to the
development language.

For example if you are using:

- PHP , you can do this

11
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

<?php $value_of_cart = 1500; ?>

<input name="_amount" value="<?php echo $value_of_cart’; ?>" id="montant"

autocomplete="off" type="text" />

- ColdFusion , you can do this

<cfset value_of_cart = 1500>

<input name="_amount" value="<cfoutput>#value_of_cart#</cfoutput>”

id="montant" autocomplete="off" type="text" />

NB: The amount of the cart have to be inserted in the field programmatically by the
merchant website

4.6. Display button

When the button of the source code has been pasted into the page it should be displayed, it is
visible on the page and click on this button redirects the customer to the merchant's MOMO
platform for payment.

Figure 22. Merchant web site example

12
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization
 Mobile Money Online Platform Date :
Version : 1.7
USER GUIDE (MERCHANT) 09/12/2016

4.7. Transaction Result

After the transaction completion, a JSON result will be sent to the website caller

1- If the result is successfully completed the result will be

{"StatusDesc":"Successfully processed transaction.","OperationDate":"2016-07-15

18:04:05","Amount":"250","SenderNumber":"237680975211","OperationType":"MoMoRequestPa
yment","StatusCode":"01","TransactionID":"2832031","ProcessingNumber":"1468602210661-
2412-0909233965"}

The website will parse the returned result to give a correct response to the user.

2- If the transaction fails the result will be

{"StatusDesc":"General failure.","OperationDate":"2016-07-15
18:15:22","Amount":"250","SenderNumber":"237680975211","OperationType":"MoMoRequestPa
yment","StatusCode":"100","TransactionID":"2832034","ProcessingNumber":"1468602886414-
2412-6845747551"}

4.8. CodeLess Code

MoMo platform can be used on all new technologies such as JAVA, .Net, Android, PHP

To intgrate MoMo on your project, you will access a web service called by this URL, some
parameters will change on:

1.4.1. For the RequestPayement and Donate CodeLess Code

https://developer.mtn.cm/OnlineMomoWeb/faces/transaction/transactionRequest.xhtml?idbouton
=2&typebouton=PAIE&_amount=AMOUNT&_tel=CLIENT_NUMBER&_clP=&_email=MERCHAN
T_EMAIL&submit.x=104&submit.y=70

AMOUNT: The amount of the transaction

CLIENT_NUMBER: The number of the client who want to perform the transaction

MERCHANT_EMAIL: The email of the merchant, this email must be registered on the platform

For security reason Codeless Code are not available for Refund action

13
© This document is belongs to ITGStore / MTNC and cannot be shared without proper authorization