Commerce Connect - API Document

Steps to integrate Commerce Connect Android SDK are given below

• Server Side API to Create Session Token.
• Install FirstConnect Android SDK.
• Instantiate and Initialize Commerce Connect Android SDK.
• Handle Success and Failure Events.

Server Side API to Create Session Token

To do Payment Transaction, the merchant application should sign the contract with Commerce Connect and get the following details to initiate the payment process with FirstData

• Merchant ID
• Config ID (Page ID)
• AES Encryption KEY [Secret Key, Plain Text]
• Request Params based on the Merchant Payment Types – There are four different format of Request Params
  a. HOSTED PAGE INTEGRATION.
  b. MERCHANT PAYMENT MODE INTEGRATION.
  c. MERCHANT PAYMENT MODE BANK OR WALLET INTEGRATION.
  d. MERCHANT PAYMENT MODE CARD INTEGRATION.
  

From merchant app, we need to create an API which makes the below 2 API calls internally (HMAC, SESSION TOKEN) and return the SESSION TOKEN. For implementing this we have a separate implementation guide (WEB SDK INTEGRATION GUIDE).

NOTE: We are calling the API's from server side to ensure the security. Refer server side implementation.

Install Commerce Connect Android SDK

• Download the latest version of the Android SDK and place the firstpay-android-0.1.aar, razorpay-android-3.8.6.aar file inside the libs folder.
• Add the code given below to your project's top-level build.gradle file:
  This gives access to the SDK library.


    allprojects
    {
        repositories {
            flatDir {
                dirs 'libs'
            }
        }
    }
                        

• Add the following lines of code to your app's build.gradle file:


    implementation files('libs/FirstPaySDK.aar')
    implementation files('libs/razorpay-android-3.8.6.aar')

    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.core:core-ktx:1.3.2'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    // Navigation & Lifecycle arch
    def nav_version_ktx = '2.2.0-beta01'
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version_ktx"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version_ktx"
    implementation "androidx.lifecycle:lifecycle-extensions:$nav_version_ktx"

    // For android ui
    def ui_component_version = "1.0.0"
    implementation "androidx.recyclerview:recyclerview:$ui_component_version"
    implementation "androidx.cardview:cardview:$ui_component_version"
    implementation "androidx.gridlayout:gridlayout:$ui_component_version"

    //Retrofit for Webservice
    implementation 'com.jakewharton.retrofit:retrofit2-kotlin-coroutines-adapter:0.9.2'
    implementation "com.squareup.retrofit2:converter-moshi:2.4.0"

    // For Kotlin Coroutines
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.0'
    implementation 'com.google.code.gson:gson:2.8.5'

    //Glide for image load
    implementation 'com.github.bumptech.glide:glide:4.9.0'
                    

• Open /app/manifest/AndroidManifest.xml and add the following uses-permission element after the application element.


    uses-permission android:name="android.permission.INTERNET"/>
    uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
                    

• Include the following proguard rule filesL:

    -dontwarn com.firstdata.fdsdk.**
    -keep class com.firstdata.fdsdk.** {*;}