Native Apps Integration

The native SDKs for Custom UI solution allows you to integrate the same in your native Apps for both Android and iOS. This document provides the steps required to integrate the solution in your App for processing seamless payments from your customers.

Custom UI SDK Android versions

The Custom UI SDK for Android is available with different versions. These versions support different features as per your requirements. Please refer to the table below for different supported versions.

Android SDK version	Features	Status
com.paytm.nativesdk:core-wr:1.3.4	Support of CVV less transactions for Saved and tokenized cards	Published
com.paytm.nativesdk:core:1.3.4	Support of CVV less transactions for Saved and tokenized cards	Published
com.paytm.nativesdk:core-wr:1.3.3	Updated Google Play Core library version.	Published
com.paytm.nativesdk:core:1.3.3	Updated Google Play Core library version.	Published
com.paytm.nativesdk:core-wr:1.3.2	Bug Fixed	Published
com.paytm.nativesdk:core:1.3.2	Bug Fixed	Published
com.paytm.nativesdk:core-wr:1.3.1	Removal of READ_PHONE_STATE permission, updated dependencies.	Published
com.paytm.nativesdk:core:1.3.1	Removal of READ_PHONE_STATE permission, updated dependencies.	Published
com.paytm.nativesdk:core-wr:1.3.0	Removal of jcenter from SDK, updated dependencies and bug fixes	Published
com.paytm.nativesdk:core:1.3.0	Removal of jcenter from SDK, updated dependencies and bug fixes	Published
com.paytm.nativesdk:core-wr:1.2.6	Removal of jcenter from SDK and updated dependencies	Published
com.paytm.nativesdk:core:1.2.6	Removal of jcenter from SDK and updated dependencies	Published
com.paytm.nativesdk:core-wr:1.2.5	Includes core SDK features along with the support of Redirection in case the Paytm app is not present, merchant powered OTP page, functionality to check logged in Paytm users using mobile number, COFT support and Bug fixes.	Published
com.paytm.nativesdk:core-1.2.5	Includes core SDK features along with the support of merchant powered OTP page, functionality to check logged in Paytm users using mobile number, COFT support and Bug fixes.	Published
com.paytm.nativesdk:core-wr:1.2.4	Includes core SDK features along with the support of Redirection in case the Paytm app is not present, merchant powered OTP page, functionality to check logged in Paytm users using mobile number and COFT support.	Published
com.paytm.nativesdk:core:1.2.4	Includes core SDK features along with the support of merchant powered OTP page, functionality to check logged in Paytm users using mobile number and COFT support.	Published
com.paytm.nativesdk:core-wr:1.2.3	Includes core SDK features along with support of Redirection in case Paytm app not present, merchant powered OTP pages and functionality to check logged in Paytm users using mobile number	Published
com.paytm.nativesdk:core:1.2.3	Includes core SDK features along with support of merchant powered OTP pages and functionality to check logged in Paytm users using mobile number	Published
com.paytm.nativesdk:core-wr:1.2.2	Includes core SDK features along with support of Redirection in case Paytm app not present	Published
com.paytm.nativesdk:core:1.2.2	Includes core SDK features with Direct bank integration	Published
com.paytm.nativesdk:core-nodp:1.2.1	Includes core SDK features without Direct bank page	Published
com.paytm.nativesdk:core-vs:1.0.0	Includes core SDK features along with Visa one click	Available on request
com.paytm.nativesdk:core-ep:1.0.0	Includes core SDK features along with OTP Auto read through Assist	Available on request

Note: To support PSP Apps (UPI Intent) or to invoke Paytm app for Target SDK version 30 ( Android 11) and above. Please add below query in AndroidManifest.xml.

<queries>
  <package android:name=“net.one97.paytm” />
    <intent>
      <action android:name=“android.intent.action.MAIN” />
    </intent>
</queries>

Pre-requisites

Before you begin the integration, make sure you follow the steps below:

Create an account on Paytm as a merchant. Click how to create an account.

Note: Save the MID and merchant key generated in the above step.
If applicable, the additional details such as Client Id and Client Secret Key will be shared with you over an email after the approval.
Go through the checksum logic to understand how to generate and validate the checksum.
Get the staging android or iOS Paytm app for integration testing on the merchant staging environment. For login into the staging Paytm app, use mobile no. 7777777777 and OTP 888888.
Get the sample merchant app to go over the different methods available in the SDK. Please get the sample apps for both android and iOS from here.

Integration types

Paytm Custom UI SDK can be integrated into two ways:

Integration Type 1 - Merchant links Paytm user's account without OTP

In this integration, merchants can link the Paytm user account through one-time consent. After the consent you can retrieve and present the following instruments on your checkout page as per your theme and design:

Paytm Wallet and Postpaid
Saved Cards of Paytm users
UPI linked bank accounts

In order to present these on your checkout page, you need to get approval for a couple of additional parameters such as client id and client secret key. Please contact your account manager or click here to apply for the same. For this integration type, please refer to the following steps:

Note: Client id and client secret key along with Paytm user’s SSO token should not be shared with anyone.

Integration Type 2 - Merchant invokes Paytm app for user's saved instruments

In this integration type, a merchant can simply invoke the Paytm app for the transactions processing through Paytm user's instruments such as wallet, postpaid, saved cards and bank accounts. For this integration type, please refer to the following steps:

Custom UI Integration - SDK Initialisation

1

Addition of Dependencies
1. Add the below line to the ‘repositories’ section of your project-level build.gradle file.
```
maven {
    url "https://artifactory.paytm.in/libs-release-local" 
}
```
2. Add below line to ‘dependencies’ section of your app build.gradle.
```
implementation "com.paytm.nativesdk:core-wr:1.2.2"
```
2

Initialisation of SDK
Initialise the SDK in the onCreate of Application class or before calling any method of SDK.

Signature:
```
PaytmSDK.init(context: Context)
```
Method Parameter:
```
context: Application Context
```

Once the SDK is initialised, please move to the next part for continuing the integration.

Staging Credentials

Login to dashboard.paytm.com with your Paytm account details.
Click on API keys under the Developer settings in the left menu.
Click the Generate now button under the Test API Details.

Note: MID and merchant keys generation may take few minutes. In case you do not see these details, please logout and login after 5 minutes. Proceed now to generate these keys.