Custom UI SDK Integration - Optional Methods

paytmSDK.openPaytmAppForAddMoneyToWallet(activity)

<net.one97.paytm.nativesdk.common.widget.PaytmConsentCheckBox
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:text="Allow <Merchant> to fetch Paytm instruments"
   app:consentButton="@drawable/customised_checkbox"
   app:consentCheckboxColorStateList="@drawable/consent_colorstatelist"
   app:consentTextAppearance="@style/ConsentTextAppearance"
   app:consentBackgroundColor="@color/gray"/>

PaytmPaymentsUtilRepository paymentsUtilRepository =PaytmSDK.getPaymentsUtilRepository()
paymentsUtilRepository.userHasSavedInstruments(context, mid)

This method will return a boolean parameter.

3

Model Name: UpiDataRequestModel

Creation of Object:

UpiDataRequestModel requestModel = new UpiDataRequestModel(vpa,bankAccount)

Constructor Parameters:

Method Parameters:

Usage:

paytmSDK.fetchUpiBalance(this, upiDataRequestModel)

Response:

Result will be received in PaytmSDKCallbackListener and can be obtained as shown:

{   // value of data
  "statusCode": 100,
  "statusMsg": "SUCCESS",
  "totalBalance": "12345.6"
}

Creation of Object:

UpiDataRequestModel requestModel = new UpiDataRequestModel(vpa,bankAccount)

Usage:

paytmSDK.setUpiPin(this, upiDataRequestModel) 

Response:

Result will be received in PaytmSDKCallbackListener and can be obtained as shown:

{"statusCode":100,"statusMsg":"SUCCESS"}

Method Signature:

fun getNBList(callback: PaymentMethodDataSource.Callback<JSONObject>)

The returned result will be of NBResponse type. The bank's list can be fetched using the PayChannelOptions object that includes the list of banks.

Method Parameters:

Usage:

PaytmSDK.getPaymentsHelper()
   getNBList(object:PaymentMethodDataSource.Callback<JSONObject> {
        override fun onResponse(response: JSONObject?,) {
            Toast.makeText(this@BaseInstrumentActivity, getMessage(response),
            Toast.LENGTH_LONG).show()
        }
        override fun onErrorResponse(error: VolleyError?, errorInfo: JSONObject?) {
             Toast.makeText(this@BaseInstrumentActivity, 
                getMessage(errorInfo) ?: "Error fetching NB List", 
                Toast.LENGTH_LONG).show()  
        }
})

The sample response of Fetch NB channel can be found below:

class="language-javascript">{
    "head":{
        "requestId":null,
        "responseTimestamp":"1591622928848",
        "version":"v1"
    },
    "body":{
        "extraParamsMap":null,
        "resultInfo":{
            "resultStatus":"S",
            "resultCode":"0000",
            "resultMsg":"Success"
        },
        "nbPayOption":{
            "displayName":"Net Banking",
            "isDisabled":{
                "status":"false",
                "msg":""
            },
            "payChannelOptions":[
                {
                "isDisabled":{
                    "status":"false",
                    "msg":null
                },
                "hasLowSuccess":{
                    "status":"false",
                    "msg":""
                },
                "iconUrl":"AXIS.png",
                "isHybridDisabled":false,
                "channelCode":"AXIS",
                "channelName":"Axis Bank"
                },
                {
                "isDisabled":{
                    "status":"false",
                    "msg":null
                },
                "hasLowSuccess":{
                    "status":"false",
                    "msg":""
                },
                "iconUrl":"HDFC.png",
                "isHybridDisabled":false,
                "channelCode":"HDFC",
                "channelName":"HDFC Bank"
                }
            ]
        }
    }
}

PayChannelOptions contains the items listed below:

• String channelName - Bank Name

• String channelCode - Bank Code

• String iconUrl - Bank Logo URL

• HasLowSuccess hasLowSuccess - Information about the bank’s success rate (HasLowSuccess contains Boolean status and String msg )

PaymentsDataImpl.fetchBinDetails(cardSixDigit, 
    token value, token type, mid, reference id, object : 
    PaymentMethodDataSource.Callback {
        override fun onResponse(response: JSONObject?) {
        }
        override fun onErrorResponse(error: VolleyError?, errorInfo: JSONObject?) {
        }
    })

Attribute	Description
cardSixDigits	First six digits of the card
token	Token value used(access/txntoken)
tokenType	It can be "TXN_TOKEN", "ACCESS"
mid	Merchant ID
referenceId	Unique ID between 10 to 20 digits and is only required in case of tokenType as ACCESS. It should be similar to the value used in access token generation.

Note: Paytm SDK builder is required to be created first in case using this method with transaction token.

{
    "head":{
        "requestId":null,
        "responseTimestamp":"1591622928848",
        "version":"v1"
    },
    "body":{
        "extraParamsMap":null,
        "resultInfo":{
            "resultStatus":"S",
            "resultCode":"0000",
            "resultMsg":"Success"
        },
        "nbPayOption":{
            "displayName":"Net Banking",
            "isDisabled":{
                "status":"false",
                "msg":""
            },
            "payChannelOptions":[
                {
                "isDisabled":{
                    "status":"false",
                    "msg":null
                },
                "hasLowSuccess":{
                    "status":"false",
                    "msg":""
                },
                "iconUrl":"AXIS.png",
                "isHybridDisabled":false,
                "channelCode":"AXIS",
                "channelName":"Axis Bank"
                },
                {
                "isDisabled":{
                    "status":"false",
                    "msg":null
                },
                "hasLowSuccess":{
                    "status":"false",
                    "msg":""
                },
                "iconUrl":"HDFC.png",
                "isHybridDisabled":false,
                "channelCode":"HDFC",
                "channelName":"HDFC Bank"
                }
            ]
        }
    }
}

Usage:

PaytmPaymentsUtilRepository paymentsUtilRepository =PaytmSDK.getPaymentsUtilRepository()
paymentsUtilRepository.getLastNBSavedBank()

Method:

Usage:

PaytmPaymentsUtilRepository paymentsUtilRepository =PaytmSDK.getPaymentsUtilRepository()
paymentsUtilRepository.getLastSavedVPA()

Response:

public func openPaytm(selectedPayModel: PaytmNativeSDK.AINativeInhouseParameterModel, 
         merchantId: String, 
         orderId: String, 
         txnToken: String, 
         amount: String, 
         callbackUrl: String?, 
         delegate: PaytmNativeSDK.AIDelegate, 
         environment: PaytmNativeSDK.AIEnvironment)

{
    "nameValuePairs": {
        "ORDERID": "PARCEL16105282330",
        "MID": "AliSub58582630351896",
        "TXNID": "20210113111212800110168877474890508",
        "TXNAMOUNT": "1.00",
        "PAYMENTMODE": "PPI",
        "CURRENCY": "INR",
        "TXNDATE": "2021-01-13 14:27:12.0",
        "STATUS": "TXN_SUCCESS",
        "RESPCODE": "01",
        "RESPMSG": "Txn Success",
        "MERC_UNQ_REF": "test4",
        "UDF_1": "test1",
        "UDF_2": "test2",
        "UDF_3": "test3",
        "ADDITIONAL_INFO": "test5",
        "GATEWAYNAME": "WALLET",
        "BANKTXNID": "151096542207",
        "BANKNAME": "WALLET"
    }
}

func convertStringToJSON(jsonString : String) -> [String : Any]? {
    if let jsonString1 = jsonString.removingPercentEncoding {
        let jsonData = jsonString1.data(using: .utf8)!
        if let dictionary = try? JSONSerialization.jsonObject(with: jsonData, 
             options: .mutableLeaves) as? [String : Any]{
            return dictionary
        }
    }
    return nil
}

enum MerchantPaymentStatus:String {
    case none = "PYTM_100"
    case initiated = "PYTM_101"
    case paymentMode = "PYTM_102"
    case paymentDeduction = "PYTM_103"
    case errorInParameter = "PYTM_104"
    case error = "PYTM_105"
    case cancel = "PYTM_106"
}

self.appInvoke.saveNetBankingMethod(channelCode: channelCode)

self.appInvoke.getSavedNetBankingMethod()

self.appInvoke.saveVPA(vpa: vpaAddress)

self.appInvoke.getSavedVPA()

fun fetchNetBankingChannels(selectedPayModel : AINativeNBParameterModel,
    delegate: AIDelegate)

Parameter	Description
selectedPayModel	An instance of class AINativeNBParameterModel with initializer: init(withTransactionToken txnToken, orderId, shouldOpenNativePlusFlow, mid, flowType, paymentModes, channelCode, ssoToken, redirectionUrl)
AIDelegate	It is Paytm SDK Callback listener, used to get callback of ProcessTransaction API

3

Merchants can use setEnvironment() method to select between the available environments:

• case .production
• case .staging

3

Note:

1. Check box is by default - true
2. View should be once visible to users to fetch authcode

Create a view outlet as an object of AINativeConsentView.

For Example: @IBOutlet weak var consentView: AINativeConsentView!)

final public func setBackgroundColor(_ color: UIColor)
final public func setFontFamily(_ family: String)
final public func setFontSize(_ size: CGFloat)
final public func setFont(_ font: UIFont)
final public func setTextColor(_ color: UIColor)
final public func setSelectedCheckmarkImage(_ image: UIImage?)
final public func setSelectedCheckmarkTint(_ tintColor: UIColor)
final public func setUnselectedCheckmarkImage(_ image: UIImage?)
final public func setUnselectedCheckmarkTint(_ tintColor: UIColor)
final public func applyTheme(_ theme: PaytmNativeSDK.AINativeConsentView.Theme)

Usage Example:

consentView.applyTheme(theme)
consentView.setFontSize(12)