Create Your First Tapp Application

Step 1 - Sign Up - Sign up to become an app developer.  Add developer functionality to your existing account and create your first mobile application profile.

Step 2 - Name Your Application - Give your soon-to-be mobile application a name. You can use "My Mobile App" if you would like.

Step 3 - Upload a Logo - Give your application a visual identity by uploading a 64x64 png image.

Step 4 - Create Application - Click the "Create App" button and you will see a new developer button on your Account home screen appear.

Step 5 - Explore Developer Portal - Click on the developer tab and expand your new developer app. (click the triangle on the right of it)

Step 6 - Assign Callback - Now you need to populate a callback field to be unique for the app on the handset. You can make this value i.e.:

x-oauthflow://st_oauth_callback

the callback is to indicate to the authorization browser which activity to redirect to after your users authenticate themselves

Step 7 - Save Changes - Click the "Save Changes" button.

Step 8 - Save Your Values - Make a note of the values (copy the values somewhere) in "App Key" and "App Secret" fields.

Step 9 - Install Android 4.4 - You will need the android sdk that supports android 4.4 (API19) or higher. if you don't have Android SDK install, install it as this is out of the scope of this document.

Step 10 - Download the SimplyTapp Mobile SDK

Step 11 - Install SimplyTapp SDK - Unpack it install it from the command line:

Android Studio Setup
====================
* Select "Import Project"
* Select the build.gradle file in this directory
* Use default gradle wrapper (if you have gradle 1.8 installed, using the local
  installation will also work).

Eclipse (Android Developer Tools Version)
=========================================
We've configured gradle to generate eclipse project files.  To delete any existing
eclipse project files and generate them from scratch use:

    ./gradlew cleanEclipse eclipse

If there is an error message stating that ANDROID_HOME is not set, set the
environment variable ANDROID_HOME to your Android 4.4 SDK directory.

You can the use:  File => Import => Existing Project into workspace.  The root
Directory is this README's directory.  Uncheck "copy projects into workspace" in
the event that the box is checked.


Gradle and command line builds
==============================
To build the project on the command line you can type:

    ./gradlew clean build

The build results are:

    build/apk/TappSDK.apk

Step 12 - Edit Files - In the src folder, open package com.simplytapp.tapp.activity, and then open Class Constants.java (MoblieSdk->Tapp->src->com->simplytapp->oauth->Constants) for editing.

Step 13 - Edit Code - In the beginning of the onCreate() method, edit these lines:

Replace the text below with the issuer App Id noted in Make a payment card

public static final String ISSUER_ID =("replace this text with an issuer id"); 
Replace the text below with the App Id and App Secret noted in step 7 above

 public static final String OAUTH_CALLBACK_SCHEME =("replace this with the text before the :// of the callback url");
 public static final String OAUTH_CALLBACK_HOST = ("replace this with the text after the :// of the callback url");

Step 14 - Compile Application Code - Build the android mobile application project and create the .apk file

Step 15 - Load Application on Test Device - Get the .apk file on the phone (this is out of the scope of this document), and run it.

Go on to: Issuing the card

Loading your First Application With Key and Secret

Now that you have created your first application within the SimplyTapp secure environment it is time to get an application up and running.

Step-by-Step

Step 1 - Get Sample App Code - Download the Tapp sample application here.

Step 2 - Open source code in your Android development environment.

Step 3 - Insert Saved Keys - Insert the previously saved application keys that you were given, and that you can still find in your application control panel found on your developer account screen, into the appropriate places within the application source code.

Step 4 - Compile Application - Compile Tapp Sample application source code with your keys inserted into an executable application.

Step 5 - Download your compiled application onto your test device.

Step 6 - Open your newly installed application from your phone.

Step 7 - Set Pin - Set up your pin [four digits] and reenter your pin. It is important to note here that the only reason you are asked to setup a pin is because it is the sample application. Once you create your own application or apply our library to your existing application your will have full control over your user experience.

Step 8 - Open Wallet - Open Wallet using your newly created user pin. Once your have opened your Tapp app, which is a sample wallet, you will see a landing screen where your payment card credentials will be. However, you have not granted the sample application access to any card credentials yet and therefore you do not have any card credentials in your wallet yet.

On to Using the Mobile SDK