HTTPS/XML Specification for BANK

This document is controlled electronically. Any printed copy is for reference purposes only unless otherwise indicated. The latest version of this document is available on-line.

Distribution List Name Arnel Babierra Marco Velasco

Reugie Arizala Gopal Koka

Company PYRO PYRO PYRO Airtel Airtel-IBM Uganda Pyrogroup

Email Arnel.babierra@pyrogroup.com marco.velasco@pyrogroup.com reugie.arizala@pyrogroup.com Gopal.koka@airtel.com o sananda.maitra@pyrogroup.com

Olalekan Sananda Maitra Document Control Version Date 0.1 April 20, 2011

Author Erwin de Torres

Description Outline draft of bank features

TABLE OF CONTENTS
Conventions Used...................................................................................................3 C H A P T E R 1 : Design and Integration.....................................................................4 C H A P T E R 2 : Message Fields................................................................................4

FOREWORD
This is a working document and as such will be extended as per the Mobile Commerce-3 rd party Institution/s integration phases, as follows: Bank Balance Inquiry Mini Statement Bank to Mobile Commerce Mobile Commerce to bank Bank to Bank (within and other Banks) Registration of Bank Account

The scope of this document sets out the Soap/XML interface specification between 3 rd party financial institution/s and Airtel for the Mobile Commerce system.

Conventions Used
3rd Party Financial Institution 3PFI

CHAPTER 1:
1.1 Communication

Design and Integration

Connection between 3PFI and Mobile Commerce will be Soap/XML over HTTPS following the server-client architecture. Airtel will be the server while 3PFI as client on 3PFI initiated requests and 3PFI will be server while Airtel as client on Airtel initiated requests. 1.2 Security data Secure Sockets Layer (SSL) technology protects the Web site and secures the over the internet.

An SSL Certificate enables encryption of sensitive information during online transactions. Each SSL Certificate contains unique, authenticated information about the certificate owner. Every SSL Certificate is issued by a Certificate Authority that verifies the identity of the certificate owner. The connectivity between 3PFI and Mobile Commerce Platform is established using point to point with trusted relationship. All the data is transferred with XML over HTTPS.

CHAPTER 2:
2.1 XML Message fields

Message Fields

Notations: M mandatory, must be populated with valid data, C conditional, required if certain conditions are met O optional, may be included or not 2.1.1 Bank Balance Inquiry Bank acting as server Information request sent to Bank: Bank Name Branch Code Account Number Beneficiarys First name Beneficiarys Last name Unique Reference ID Date and time (GMT) Country Code Authorized Mobile Commerce number External Data Field 1

External Data Field 2

Information received from Bank: Status of transaction Balance amount Unique Reference ID Date and time (GMT)

2.1.2 Mini Statement Bank acting as server Information request sent to Bank: Bank Name Branch Code Account Number Beneficiarys First name Beneficiarys Last name Unique Reference ID Date and time (GMT) Country Code Authorized Mobile Commerce number External Data Field 1 External Data Field 2

Information received from Bank: Status of transaction Statement details Unique Reference ID Date and time (GMT)

2.1.3 Mobile Commerce to Bank Transfer Bank acting as server Information request sent to Bank: Bank Name Branch Code / Swift code Account Number Beneficiarys First name Beneficiarys Last name Amount Currency code Unique Reference ID Date and time (GMT) Country Code Authorized Mobile Commerce number External Data Field 1 External Data Field 2

Information received from the Bank: Status of receipt of transaction Confirmation of amount Unique Reference ID Date and time (GMT)

2.1.4 Bank to Mobile Commerce Transfer Bank acting as server Information request sent to Bank: Bank Name Branch Code Account Number Beneficiarys First name Beneficiarys Last name Amount Currency code Unique Reference ID Date and time (GMT) Country Code Authorized Mobile Commerce number External Data Field 1 External Data Field 2

Information received from the Bank: Status of receipt of transaction Authorized amount Unique Reference ID Date and time (GMT) 2.1.5 Bank to Mobile Commerce Transfer Airtel acting as server (Bank initiated) Information request sent to Bank: Bank Name - M Branch Code - M Account Number - M Beneficiarys First name - M Beneficiarys Last name - M Amount - M Currency code - M Unique Reference ID - M Date and time (GMT) - M Country Code - M Authorized Mobile Commerce number - M External Data Field 1 - O External Data Field 2 - O

Information received from the Bank:

Status of receipt of transaction Authorized amount Unique Reference ID Date and time (GMT)

2.1.6 Bank to Bank Transfer Bank acting as server Information request sent to Bank: Bank Name Branch Code / Swift code Account Number Beneficiarys First name Beneficiarys Last name Amount Currency code Unique Reference ID Date and time (GMT) Country Code Authorized Mobile Commerce number External Data Field 1 External Data Field 2

Information received from the Bank: Status of receipt of transaction Authorized amount Unique Reference ID Date and time (GMT)

2.1.7 Change of Authorized Account Number Airtel as server (Bank initiated) Information request sent by Bank: Bank Name - M Branch Code / Swift code - M Account Number - M Beneficiarys First name - M Beneficiarys Last name - M Unique Reference ID - M Date and time (GMT) - M Country Code - M Authorized Mobile Commerce number - M External Data Field 1 - O External Data Field 2 - O

Information sent to the Bank: Status of receipt of transaction Current Account Number

2.1.7 Checking of Authorized Mobile Commerce Number Airtel as server (Bank initiated) Information request sent by Bank: Authorized Mobile Commerce Number - M Beneficiarys First name - M Beneficiarys Last name - M Unique Reference ID - M Date and time (GMT) - M Country Code - M External Data Field 1 - O External Data Field 2 - O

Information sent to the Bank: Status of receipt of transaction Authorized Mobile Commerce Number