Midtrans Payment Integration in iOS

This blog will be about the integration Midtrans payment gateway in the iOS application using swift language. Before the start to integration the Midtrans payment, let you know payment type in the Midtrans payment gateway.

1. GO-PAY: Midtrans accepting transaction directly from the website or chat application.
2. AKULAKU: Midtrans Payment service without credit card from the customer account. Customers can make payments using the credit limit on my Akulaku account.
3. Indomaret: Midtrans Payment services through Indomaret outlets throughout Indonesia. Payment can be made by cash or debit.
4. Credit card: Midtrans Payment using a credit/debit card bearing the VISA / MasterCard / JCB / Amex logo, from all local and international banks.
5.Virtual Account: Transfer payment services from any local account via ATM Bersama / Prima / Alto. Facilitated by Bank Permata.
6.Mandiri clickpay: Internet banking payment service from Bank Mandiri. Payment can be made by entering a 16 digit Mandiri debit and token card.

Let start the integrate Midtrans payment gateway, for this, we have to follow some steps which I mentioned in the below

Download the Midtrans SDK using pod.
1.1 Please install Cocoapods version 1.0.0. You can find the installation guide here.
1.2 Navigate to your project’s root directory and run pod init to create a Podfile.
1.3 Open up the Podfile and add MidtransKit to your project’s target.

pod 'MidtransKit'

1

pod 'MidtransKit'

1.4 Save the file and run pod install to install MidtransKit.
1.5 Open .xcworkspace project.

After installation of MidtransKit, we have to configure it with the clientKey, merchant server URL and server environment in the AppDelegate.swift.

import MidtransKit

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
   // Override point for customization after application launch.
   MidtransConfig.shared().setClientKey("client-key", environment: .production, merchantServerURL: "server-url")
   return true

}

import MidtransKit

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

// Override point for customization after application launch.

MidtransConfig.shared().setClientKey("client-key", environment: .production, merchantServerURL: "server-url")

return true

}

In the setClientKey method we need to pass three parameter( client key,environment,merchantServerURL). We will get the client-key after creating the merchant account. Please click here to create the merchant account.
The second parameter is an environment which decides that the payment mode is live or testing. There are 4 environments in the Midtrans payment gateway.
1. production: This server type should be used only when the product ready to be released.
2.Sandbox: This server type should be used for testing.
3. Staging: This server type should be used for testing.
4. Unknown: Internal usage only.
Third and the last parameter is merchantServerURL, which is used for the server URL that you have mentioned in the signup time on the merchant account.

Important: We need to add -ObjC to the Xcode project. Navigate to your .xcodeproj file in Xcode, choose your app main target in Targets, and in the Build Settings tab, search for Other Linker Flags, double click and add -ObjC.

Now we configure the payment method and generate a transaction.
3.1 Merchant Server Implementation.
Midtrans payment gateway needs a token which is help create the payment transaction and the Merchant Server is used to create the payment token.
click here to download charge file and upload it in your server.
3.2 Get Token from charge API.

func payment(){
    let shippingAddress = MidtransAddress(firstName: , lastName: , phone: , address:, city:, postalCode:, countryCode: )   // Billing and Shipping Address
    let customerDetail = MidtransCustomerDetails(firstName: , lastName:, email: , phone: , shippingAddress:shippingAddress, billingAddress:shippingAddress)  // Customer details
    let transactionDetail = MidtransTransactionDetails(orderID: ,andGrossAmount: )    // Transaction details

    // Customer details for a generate token from charge API.
     let customer : NSDictionary = [
            "billing_address": [
                "address": "",
                "city": "",
                "country_code": "",
                "first_name": "",
                "last_name": "",
                "phone": "",
                "postal_code": ""
            ],
            "email": "",
            "first_name": "",
            "last_name": "",
            "phone": "",
            "shipping_address": [
                "address": "",
                "city": "",
                "country_code": "",
                "first_name": "",
                "last_name": "",
                "phone": "",
                "postal_code": ""
            ]
        ]
        // Item details for a genarate token from charge API.
        let item_details :NSArray = [
            [
                "id": "",
                "name": "",
                "price":,
                "quantity": 1
            ]
        ]
       // Transaction details for a genarate token from charge API.
        let transaction_details : NSDictionary = [
            "currency": "",
            "gross_amount":,
            "order_id": ""
        ]

    let parameters = [
        "customer_details": customer as Any,
        "item_details":items as Any,
        "transaction_details": transaction as Any,
        ] as [String : Any]
    
    //charge API method calling
    makeApiCalling(parameters: parameters, completion: { (response: NSDictionary?, error:String?) in
        if error == nil{    //Checking token genarate is success or fail
            var token: MidtransTransactionTokenResponse?
            // Genarate SDK Token
            token = MidtransTransactionTokenResponse.modelObject(with: response as? [AnyHashable : Any], transactionDetails: transactionDetail, customerDetails: customerDetail, itemDetails: itemDetails)
            DispatchQueue.main.async {
                if let vc = MidtransUIPaymentViewController.init(token: token){    //create PaymentView object
                    vc.paymentDelegate = self      //handle the MidtransUIPaymentViewController event
                    self.present(vc, animated: true, completion: nil)
                }
            }
        }else{
            print(error) //fail to get token from charge API
        }
    })
}



func makeApiCalling(parameters :[String : Any] ,completion: @escaping (NSDictionary?, String?) -> Void){
    
    // Must use this header to hitting charge API.
    let headers = [
        "Content-Type": "application/json",
        "cache-control": "no-cache",
        ]
    do{
        
        let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])      // convert dicnary to Data
        var request = URLRequest(url: URL(string: "https://www.server-url/charge/index.php")!)    //create url request
        request.httpMethod = "POST"    //request type
        request.allHTTPHeaderFields = headers   //set header in the request
        request.httpBody = postData   //Set body
        let dataTask = URLSession.shared.dataTask(with: request as URLRequest, completionHandler: { (data, response,error) -> Void in
            if (error != nil || data == nil) {
                completion( nil, "Connection Failed.")
            } else {
                do{
                    if let response = try JSONSerialization.jsonObject(with: data!, options: []) as? NSDictionary {
                        let errorResponse = response["error_messages"]
                        if errorResponse != nil {
                            completion( nil, errorResponse as? String)
                        } else {
                            completion( response, nil)
                        }
                    }else{
                        completion( nil, "Data Error")
                    }
                }catch{
                    completion( nil, "Server Error")
                }
            }
        })
        dataTask.resume()
    }catch{
        
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

func payment(){

let shippingAddress = MidtransAddress(firstName: , lastName: , phone: , address:, city:, postalCode:, countryCode: ) // Billing and Shipping Address

let customerDetail = MidtransCustomerDetails(firstName: , lastName:, email: , phone: , shippingAddress:shippingAddress, billingAddress:shippingAddress) // Customer details

let transactionDetail = MidtransTransactionDetails(orderID: ,andGrossAmount: ) // Transaction details

// Customer details for a generate token from charge API.

let customer : NSDictionary = [

"billing_address": [

"address": "",

"city": "",

"country_code": "",

"first_name": "",

"last_name": "",

"phone": "",

"postal_code": ""

"email": "",

"first_name": "",

"last_name": "",

"phone": "",

"shipping_address": [

"address": "",

"city": "",

"country_code": "",

"first_name": "",

"last_name": "",

"phone": "",

"postal_code": ""

]

// Item details for a genarate token from charge API.

let item_details :NSArray = [

[

"id": "",

"name": "",

"price":,

"quantity": 1

]

// Transaction details for a genarate token from charge API.

let transaction_details : NSDictionary = [

"currency": "",

"gross_amount":,

"order_id": ""

]

let parameters = [

"customer_details": customer as Any,

"item_details":items as Any,

"transaction_details": transaction as Any,

] as [String : Any]

//charge API method calling

makeApiCalling(parameters: parameters, completion: { (response: NSDictionary?, error:String?) in

if error == nil{ //Checking token genarate is success or fail

var token: MidtransTransactionTokenResponse?

// Genarate SDK Token

token = MidtransTransactionTokenResponse.modelObject(with: response as? [AnyHashable : Any], transactionDetails: transactionDetail, customerDetails: customerDetail, itemDetails: itemDetails)

DispatchQueue.main.async {

if let vc = MidtransUIPaymentViewController.init(token: token){ //create PaymentView object

vc.paymentDelegate = self //handle the MidtransUIPaymentViewController event

self.present(vc, animated: true, completion: nil)

}

}else{

print(error) //fail to get token from charge API

}

})

}

func makeApiCalling(parameters :[String : Any] ,completion: @escaping (NSDictionary?, String?) -> Void){

// Must use this header to hitting charge API.

let headers = [

"Content-Type": "application/json",

"cache-control": "no-cache",

]

do{

let postData = try JSONSerialization.data(withJSONObject: parameters, options: []) // convert dicnary to Data

var request = URLRequest(url: URL(string: "https://www.server-url/charge/index.php")!) //create url request

request.httpMethod = "POST" //request type

request.allHTTPHeaderFields = headers //set header in the request

request.httpBody = postData //Set body

let dataTask = URLSession.shared.dataTask(with: request as URLRequest, completionHandler: { (data, response,error) -> Void in

if (error != nil || data == nil) {

completion( nil, "Connection Failed.")

} else {

do{

if let response = try JSONSerialization.jsonObject(with: data!, options: []) as? NSDictionary {

let errorResponse = response["error_messages"]

if errorResponse != nil {

completion( nil, errorResponse as? String)

} else {

completion( response, nil)

}

}else{

completion( nil, "Data Error")

}

}catch{

completion( nil, "Server Error")

}

})

dataTask.resume()

}catch{

}

3.3 Now finally we handle the event from SDK.

extension ViewController: MidtransUIPaymentViewControllerDelegate {
    func paymentViewController(_ viewController: MidtransUIPaymentViewController!, save result: MidtransMaskedCreditCard!) {
       // To handle event when successfully to save card
    }
    func paymentViewController(_ viewController: MidtransUIPaymentViewController!,saveCardFailed error: Error!) {
         // To handle event when failed to save card
    }
    func paymentViewController(_ viewController: MidtransUIPaymentViewController!,paymentFailed error: Error!) {
      // To handle event when transaction is failed
    }
    func paymentViewController(_ viewController: MidtransUIPaymentViewController!, paymentPending result: MidtransTransactionResult!) {
       // To handle event when transaction is pending
    }
    func paymentViewController(_ viewController: MidtransUIPaymentViewController!,paymentSuccess result: MidtransTransactionResult!) {
       // To handle event when transaction is successfull
    }
    func paymentViewController_paymentCanceled(_ viewController: MidtransUIPaymentViewController!) {
       // To handle event when user canel the payment
    }
}

extension ViewController: MidtransUIPaymentViewControllerDelegate {

func paymentViewController(_ viewController: MidtransUIPaymentViewController!, save result: MidtransMaskedCreditCard!) {

// To handle event when successfully to save card

}

func paymentViewController(_ viewController: MidtransUIPaymentViewController!,saveCardFailed error: Error!) {

// To handle event when failed to save card

}

func paymentViewController(_ viewController: MidtransUIPaymentViewController!,paymentFailed error: Error!) {

// To handle event when transaction is failed

}

func paymentViewController(_ viewController: MidtransUIPaymentViewController!, paymentPending result: MidtransTransactionResult!) {

// To handle event when transaction is pending

}

func paymentViewController(_ viewController: MidtransUIPaymentViewController!,paymentSuccess result: MidtransTransactionResult!) {

// To handle event when transaction is successfull

}

func paymentViewController_paymentCanceled(_ viewController: MidtransUIPaymentViewController!) {

// To handle event when user canel the payment

}

Hope the above blog will help you in integrate Midtrans payment gateway in iOS using swift.

Midtrans payment gateway swift

Debabrata Roy 30 April 2019

. . .

Midtrans Payment Integration in iOS

Leave a Comment Cancel Reply

Message Sent!