Initialize Request

Initialize the payment transaction by invoking the initialize method as shown in the following code sample:

// Initialize payment

// Create ClientInfo object using builder pattern  
 let clientInfo = CPMClientInfo.make(builder: { builder in 
builder?._appId =  [CLIENT APP ID] 
builder?._profileId = [CUSTOMER PROFILE ID] 
builder?._appVersion =  [APP VERSION] 
builder?._language = [LANGUAGE] 
builder?._countryId =  CPMCountry(rawValue: UInt([COUNTRY CUSTOMER’s MOBILE NUMBER IS REGISTERED IN])!)!
builder?._mobile =  [CUSTOMER’S MOBILE NUMBER]              
builder?._email = [CUSTOMER’S EMAIL] 
builder?._customerRef = [CUSTOMER REFERENCE] 
      })
// Call initialize on mPoint SDK

 let info = mPointInitializeInfo.make { (builder:mPointInitializeBuilder?) in
            builder?._orderno = self.mPointMgr.orderNo
            let initAmount = Utility.generateInitializeAmount()
            if (initAmount == 0) {
                Utility.displayErrorAlert(message:"Error in generating amount for initialize", viewController: self)
                return
            }
            builder?._amount = initAmount [txn amount]
            builder?._info = clientInfo
            builder?._countryid = CPMCountry(rawValue: UInt(client.countryId)!)!
            builder?._transactionId = Int(String(format:"970%i",arc4random() % 999 ))!
            client.amount = "\(initAmount)"
            if !client.saltString.isEmpty {
            builder?._secretSalt = client.saltString
     }
            builder?._currencyId = client.currencyId
            // auth token should be sent in initialize request
            if !client.authToken.isEmpty {
                builder?._authtoken = client.authToken
            }

\\orderInfo is AID data\\
            builder?._orderInfo = Utility.generateOrderInfo()
            // Set session Id     
            if self.mPointMgr.sessionId > 0 {
                builder?._sessionId = self.mPointMgr.sessionId
            }
            builder?._typeid = .MPOINT_SHOPPING_ONLINE

            // Add holding fee if it is present. Holding fee is required for offline payments.
            if (AdditionalData.holdingFee != nil && AdditionalData.holdingFee?.isEmpty == false) {
                builder?._fee = Utility.generateHoldingFeeAmount(countryId: countryId)
            }
            if (!client.sessionToken.isEmpty) {
                builder?._additionalData = ["session_token": client.sessionToken]
            }
    }
        Self.mPointMgr.initialize(initializeInfo: info)

Request Parameters

The descriptions of the initialize payment parameters are listed in the table below.

Callback

Implement the displayAvailablePayments callback method to display the available payment options as shown in the following code sample. In the displayAvailablePayments, the following sub-objects are available:

• Card
• Stored card
• APM
• Third-party wallet
• Aggregators
• Offline payment
• Vouchers
• SplitPayment

func display(_ availablePayments: mPointAvailablePayments!, mPoint mpoint: mPointManager
!) {
for card in availablePayments._cards.values {
if let c = card as? mPointCardInfo, !isAPM(card: c), !isWallet(card: c), (c._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED ||
c._state == mPointCardStates.MPOINT_CARD_STATE_DISABLED_BY_MERCHANT || c._state == mPointCardStates.MPOINT_CARD_DISABLE_SHOW) {
                mpointMgr.cards.append(c)
   }

}
// Read wallet cards
if let walletCardsArray = availablePayments._walletCards as? [mPointCardInfo], walletCardsArray.count > 0 {
            for walletCard in walletCardsArray {
                if (walletCard._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED || walletCard._state == mPointCardStates.MPOINT_CARD_STATE_DISABLED_BY_MERCHANT || walletCard._state == mPointCardStates.MPOINT_CARD_DISABLE_SHOW) {
                    mpointMgr.wallets.append(walletCard)
                }
            }
        }

// Read APMs
        if let apmsArray = availablePayments._apms as? [mPointCardInfo], apmsArray.count > 0 {
            for apm in apmsArray {
                if(apm._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED || apm._state == mPointCardStates.MPOINT_CARD_STATE_DISABLED_BY_MERCHANT || apm._state == mPointCardStates.MPOINT_CARD_DISABLE_SHOW) {
                    mpointMgr.apms.append(apm)
                }
            }
      }
// Read aggregators
        if let aggregators = availablePayments._aggregators as? [mPointCardInfo], aggregators.count > 0 {
            for aggregator in aggregators {
                if aggregator._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED {
                    mpointMgr.aggregators.append(aggregator)
                }
            }
             // Read payment center cards
            let offlineCards = availablePayments._offlineCards
            for offlineCard in offlineCards {
                if offlineCard._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED {
                    mpointMgr.offlineCards.append(offlineCard)
                }
            }
        // Read vouchers
            let vouchers = availablePayments._vouchers
            for voucher in vouchers {
                if voucher._state == mPointCardStates.MPOINT_CARD_STATE_ENABLED {
                    mpointMgr.vouchers.append(voucher)
                }
            }
       // Read split payment combinations
       let splitPayment = availablePayments._splitPayment ?? mPointSplitPayment()
let combinationsArray = splitPayment.configurations._applicableCombinations
for combination in combinationsArray {
mpointMgr.splitCombinations.append(combination)
}
}

Callback Parameters

The descriptions of the parameters are listed in the table below.