MOBILE MONEY ONLINE PLATFORM Project number: PRMTN160104
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
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
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
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
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
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
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
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
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
Figure 13. Change language 1.4. Update profile The modification of the profile once connected is done as follows: Figure 14. Update profil 7
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
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
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
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
<?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
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