safaricom/LNMOnlineAndroidSample

Lipa Na Mpesa Android Sample

This app demonstrates how to impeliment Lipa Na MPESA Online. Documentation on the API can be found on [Safaricom Developer Portal] (https://developer.safaricom.co.ke/docs)

Requirements

• JDK Version 1.7 & above
• Android Studio

Getting Safaricom Credentials

1. Create an account on the [Safaricom Developer Portal] (https://developer.safaricom.co.ke/)
2. Create a Lipa na MPESA Online App

Project Setup

1. Rename sample.gradle.properties file to gradle.properties then add you Consumer key and Consumer secret.
2. Copy sample-google-services.json inside app directory and rename it to google-services.json. This will ensure your project build without an error.

NB

sample-google-services.json is just a sample file to help you bypass build error due to a google-services.json missing.

Firebase Setup

In order to send push notifications to the user, you will need to setup [FCM - Firebase Cloud Messaging Service] (https://firebase.google.com/docs/cloud-messaging/android/client). AndroidHive has an awesome tutorial on this.

Screenshots

Add an item to the cart:

Add a customers phone number:

The STK push payment popup is sent to the customer phone:

MPESA confirmation message:

Payment confirmation from the API callback:

Libraries Used

1. [Sweet alerts] (https://github.com/pedant/sweet-alert-dialog)
2. [Butterknife] (https://github.com/JakeWharton/butterknife)
3. [Retrofit] (http://square.github.io/retrofit/)
4. [GSON] (https://github.com/google/gson)
5. [FireBase] (https://firebase.google.com/docs/android/setup)
6. [Okhttp] (http://square.github.io/okhttp/)
7. [okio] (https://github.com/square/okio)
8. OkHttp Interceptors
9. [Timber] (https://github.com/JakeWharton/timber)