MOBIWIRE

SPECIFICATION

MOBIPRINT
JAVA MIDLET
SPECIFICATION
Author:
Fares MOUNSI
Number of Pages : 7
79 avenue Franois Arago
Challenge 92 Building
92017 Nanterre
France
Creation Date:
7
th
March 2012



Mailing list :
David Charlot
Bruno Mortreux






Summary
INTRODUCTION ........................................................................................................................................................................ 2
APPLICATION MENU .......................................................................................................................................................... 2
THE TOP UP APPLICATION ................................................................................................................................................. 2
THE CASH PAYMENT FOR TOP-UP ............................................................................................................................... 2
THE M-WALLET PAYMENT FOR TOP-UP ...................................................................................................................... 2
THE E-VOUCHER .................................................................................................................................................................. 3
THE CASH PAYMENT FOR E-VOUCHER BUYING.......................................................................................................... 3
THE M-WALLET PAYMENT FOR E-VOUCHER BUYING ................................................................................................ 3
OTHERS ................................................................................................................................................................................. 4
CREATE CUSTOMER ACCOUNT ................................................................................................................................... 4
CREDIT CUSTOMER ACCOUNT .................................................................................................................................... 4
APPENDIXES ............................................................................................................................................................................... 5
TOP-UP WITH CASH PAYMENT FLOW CHART ................................................................................................................ 5
TOP-UP WITH M-PAYMENT FLOW CHART: ....................................................................................................................... 5
E-VOUCHER WITH CASH PAYMENT ................................................................................................................................... 6
E-VOUCHER WITH M-PAYMENT .......................................................................................................................................... 7



MobiPrint JAVA MIDlet Specification


MobiPrint JAVA MIDlet Specification
Introduction

This document is a specification for the Generic JAVA MIDlet that will be developed for MobiPrint.
The MIDlet will be adaptable to different customers as the applications for MobiPrint are very similar from
one customer to another.
In this document, we will explain in details what are the functions and mechanisms used to make the MIDlet
work.
The first part will give an overview of the Top Up and e-Voucher applications.
The second part will introduce the JAVA MIDlet and the functions that we need in the MIDlet.
APPLICATION MENU
The Main Menu of the MIDlet will display the following items
1- Top-Up
a. Cash Payment
b. m-Payment
2- e-Voucher
a. Cash Payment
b. m-Payment
3- Others
a. Create Customer Account
b. Credit Customer Account

Each one of those items is described below.
The Top Up application
Mobile phone users with a prepaid sim card need to credit their prepaid account when they have used all the
money/airtime available on their account.

The Top Up application will be used to buy airtime and print a ticket as a receipt of the transaction for the
customer.
There are two ways of buying airtime in our case; first by cash and second by using the m-Wallet (mobile
wallet). Both solutions are described below.
The Cash payment for Top-Up
1- The customer enters the amount of the transaction and his account information (phone number).
2- The MobiPrint sends a request to the operator/ service provider server (https, SMS or USS) to credit
the airtime account with the given amount of money.
3- The server sends back information needed for ticket printing to validate the transaction.
4- The MobiPrint prints the Ticket with the new account balance of airtime, transaction number and
confirmation.

Please check the flow Chart Top-Up Cash Payment flow chart in the annex below
The m-Wallet payment for Top-Up
After the customer created and credited an account (check the Other chapter), he can purchase goods and
receive a receipt for the transactions he makes.

MobiPrint JAVA MIDlet Specification


The mobile wallet is a way of making payments allowing customer to purchase goods and in case of Top-Up,
minutes of communication (air time) with his account created on the supplier/service provider side. He needs
his mobile phone, as in most of the cases; he will receive an SMS to confirm the transaction.
How does it work?
1- The customer enters the amount of the transaction and his account information (phone number and
secret code).
2- The MobiPrint sends a request to the operator/ service provider server (https, SMS or USS) to credit
the airtime account with the given amount of money and debit the MobiBANK account with the
same amount.
3- The server sends back information needed for ticket printing to validate the transaction.
4- The MobiPrint prints the Ticket with the new account balance of airtime, transaction number and
confirmation.
5- The MobiPrint will print a ticket with the new account balance of MobiBANK account.
The e-Voucher
The e-Voucher is very similar to the Top-Up except that it is specifically used for ticketting.
The customer pays by cash or using his m-Wallet and receives a ticket allowing him to get the service he paid
for.
The applications are various. It can be lottery, events, or movies ticket selling as well as e-Vouchers to credit
an airtime account.
The Cash payment for e-Voucher buying
1- The customer enters the amount of the transaction.
2- The MobiPrint sends a request to the operator/ service provider server (https, SMS or USS)
3- The server sends back information needed for ticket printing (code for airtime e-Voucher; numbers for
lottery; Seat number for Football match, etc)
4- The MobiPrint will print the Ticket with the corresponding information.

This generic process can be used to buy airtime e-Voucher, Lottery ticket, Movie ticket, Football match ticket
or any other ticket selling event.
So, there will be customizable submenus to this Application for each type of ticket selling.
We will start with the following:
1- Airtime e-Voucher
2- Lottery ticket
a. Random Numbers
b. Chosen Numbers
3- Movie ticket
4- Football Match ticket

Please check the flow Chart e-Voucher Cash Payment flow chart in the annex below
The m-Wallet payment for e-Voucher buying
As the customer created and credited his account (check the Other chapter), he can now purchase goods
and receive a receipt for the transactions he makes.

The mobile wallet is a way for making payments allowing customer to purchase goods and in case of Tickets
with his account created on the supplier/service provider side. He needs his mobile phone, as in most of the
cases; he will receive an SMS to confirm the transaction.
How does it work?
1- The customer enters the amount of the transaction as well as his account information and secret code.
MobiPrint JAVA MIDlet Specification


2- The MobiPrint sends a request to the operator/ service provider server (https, SMS or USS)
3- The server sends back information needed for ticket printing (code for airtime e-Voucher; numbers for
lottery; Seat number for Football match, etc)
4- The MobiPrint will print the Ticket with the corresponding information.
5- Once the transaction is confirmed the MobiBANK account of the customer is debited and the New
MobiBANK balance account is displayed and can be printed.

Others

Create Customer Account
The Application will prompt the user to enter the following personal data:
1- First Name, Last Name
2- Phone Number
3- First Deposit Amount
Once the customer enters those details, the data are sent to a server using https connection with SSL.
The MIDlet must be signed with the right certificate.
The server creates a new entry in the customer distant server database with the personal data from the
customer and creates an account number as well as a secret password and credits the account with the First
Deposit Amount.
We call this account MobiBANK account in this document.
The MobiBANK Account Number and Secret Password are sent to the customer on his mobile phone using
an SMS or by e-mail.
The MobiPrint prints a ticket to confirm the creation of the account with all information except secret
password.

Credit Customer Account
The application will prompt the user to enter the following personal data:
1- First Name, Last Name
2- Phone Number
3- Amount to be credited
4- Account Number
Once the customer has paid the amount to be credited in cash to the service provider/reseller, the MobiBANK
account of the customer is credited with the same amount and the database is updated.
The MobiPrint prints a ticket to confirm the transaction with amount credited on the account.

Appendixes
Top-Up with Cash Payment flow Chart

Top-Up with m-payment flow chart:

1- Top-Up
2- e-Voucher
3- Others
EXIT OK
1-Cash Payment
2- m-Payment
BACK OK
Please Enter:
Phone Number:
Amount ($): XXX$
BACK OK
You have credited your airtime
account with XXX$
Your Airtime available is
......$
MAIN MENU PRINT
Print Ticket.
You have credited your airtime
account with XXX$
Your Airtime available is
......$
MAIN MENU PRINT
1- Top-Up
2- e-Voucher
3- Others
EXIT OK
1- Top-Up
2- e-Voucher
3- Others
EXIT OK
1-Cash Payment
2- m-Payment
BACK OK
Please Enter:
Phone Number:
Amount ($): XXX$
MobiBANK
Account Number:
Secret Code:
BACK OK
You have credited your airtime account with
XXX$
Your Airtime available is
......$
Your MobiBANK account has been debited with
XXX$
Your New MobiBANK balance is .......$
Thank You
MAIN MENU PRINT
_______________
Print Ticket
_____
_
____________
______________
__________
______________
____________
______________
_______________
_____________
_____________
____________
You have credited your airtime
account with XXX$
Your Airtime available is
......$
MAIN MENU PRINT
1- Top-Up
2- e-Voucher
3- Others
EXIT OK
MobiPrint JAVA MIDlet Specification


e-Voucher with Cash Payment
The example below is specific to the airtime e-Voucher. It needs to be adapted a little bit depending on the
area of application (lottery, cinema, etc..).


1- Top-Up
2- e-Voucher
3- Others
EXIT OK
1-Cash Payment
2- m-Payment
BACK OK
Please Enter the
Amount ($):
XXX $
BACK OK
You have requested an airtime
e-voucher for an amount of XXX $
Please use the following code to
credit your airtime account on your
mobile phone:
############
Transaction Number :
***************
Thank you for choosing our solution
MAIN MENU PRINT
Print Ticket
You have requested an
airtime e-voucher for an
amount of XXX$
Please use the following
code to credit your
airtime account on your
mobile phone:
############
Transaction Number :
***************
Thank you for choosing
our solution
You have credited your airtime
account with XXX$
Thank you for choosing us
MAIN MENU
PRINT
1- Top-Up
2- e-Voucher
3- Others
EXIT OK
MobiPrint JAVA MIDlet Specification


e-Voucher with m-payment
The example below is specific to the airtime e-Voucher. It needs to be adapted a little bit depending on the
area of application (lottery, cinema, etc..).

1- Top-Up
2- e-Voucher
3- Others
EXIT OK
1-Cash Payment
2- m-Payment
BACK OK
Please Enter the
Amount ($):
XXX $
MobiBANK
Account Number:
Secret Code:
BACK OK
You have requested an airtime
e-voucher for an amount of XXX $
Please use the following code to
credit your airtime account on your
mobile phone:
############
Transaction Number :
***************
Your MobiBANK account has
been debited with XXX$
Your New MobiBANK balance is
.......$
Thank you for choosing our solution
MAIN MENU PRINT
Print Ticket
You have requested an
airtime e-voucher for an
amount of XXX$
Please use the following
code to credit your
airtime account on your
mobile phone:
############
Transaction Number :
***************
Your MobiBANK
account has been debited
with XXX$
Your New MobiBANK
balance is .......$
Thank you for choosing
our solution
You have credited your airtime
account with XXX$
Thank you for choosing us
MAIN MENU PRINT
1- Top-Up
2- e-Voucher
3- Others
EXIT OK