Hi guys, today we will learn about how to implement Tap Payment Gateway for an iOS application in Swift.

Let us know first what is the Payment gateway.

A payment gateway bridges the gap between customers, banks and online business. It safely and securely passes all the sensitive information such as customer’s credit card numbers and so on, from one end to the other. It is used for online transactions with the customer. It is a merchant service provided by an e-commerce application service provider that authorizes credit card or direct payments processing for e-businesses, online retailers, bricks and clicks, or traditional brick and mortar.

Now we can start the steps to integrate the payment gateway.

Step to Integrate Tap Payment Gateway

Step 1 => Add ‘goSellSdk’ in the project

To integrate goSellSDK into your Xcode project using CocoaPods, specify it in your Podfile:

target 'MyAPP' do 
    pod 'goSellSDK' 
end

target 'MyAPP' do

pod 'goSellSDK'

end

and then run this command in the terminal

pod install

1	pod install

Step 2 => Setup of SDK

To set it up, add the following line of code somewhere in your project and make sure it will be called before any usage of goSellSDK, otherwise, an exception will be thrown.

let secretKey = SecretKey(sanbox: "YOUR_SANDBOX_SECRET_KEY", production: "YOUR_PRODUCTION_SECRET_KEY") // (format of the key: "sk_XXXXXXXXXXXXXXXXXXXXXXXX")
goSellSDK.secretKey = secretKey // Secret key (format: "sk_XXXXXXXXXXXXXXXXXXXXXXXX")

1 2	let secretKey = SecretKey(sanbox: "YOUR_SANDBOX_SECRET_KEY", production: "YOUR_PRODUCTION_SECRET_KEY") // (format of the key: "sk_XXXXXXXXXXXXXXXXXXXXXXXX") goSellSDK.secretKey = secretKey // Secret key (format: "sk_XXXXXXXXXXXXXXXXXXXXXXXX")

Step 3 => Setup of Play Button

a) Using StoryBoard

Drag & drop an instance of UIView at the desired location.
Select added view and open Identity Inspector
Enter the following values:
1. Class: PayButton
2. Module: goSellSDK

b) Using code

import goSellSDK
func addPayButton() {

    let buttonFrame = CGRect(x: 8.0, y: UIScreen.main.bounds.height - 52.0, width: UIScreen.main.bounds.width - 16.0, height: 44.0)
    let button = PayButton(frame: buttonFrame)
    self.view.addSubview(button)
    
    button.dataSource = self
    button.delegate = self 
}

import goSellSDK

func addPayButton() {

let buttonFrame = CGRect(x: 8.0, y: UIScreen.main.bounds.height - 52.0, width: UIScreen.main.bounds.width - 16.0, height: 44.0)

let button = PayButton(frame: buttonFrame)

self.view.addSubview(button)

button.dataSource = self

button.delegate = self

}

Step 4 => Implementing SessionDataSource and SessionDelegate

You have to implement SessionDataSource and SessionDelegate in the viewController where you have set up the Play button. Create an extension of the controller and add this code.

    var mode: TransactionMode {
        
        return .purchase
    }
    var customer: Customer? {
        return self.newCustomer
    }
    
    /// Creating a customer with known identifier received from Tap before.
    var identifiedCustomer: Customer? {
        
        return try? Customer(identifier: "cus_to_mer")
    }
    
    /// Creating a customer with raw information.
    var newCustomer: Customer? {
        
        let emailAddress = try! EmailAddress(emailAddressString: JSONData["tabData"]["customerEmail"].stringValue)
        let phoneNumber = try! PhoneNumber(isdNumber: JSONData["tabData"]["countryCode"].stringValue, phoneNumber: JSONData["tabData"]["telephone"].stringValue)
        
        return try? Customer(emailAddress:  emailAddress,
                             phoneNumber:   phoneNumber,
                             firstName:      JSONData["tabData"]["firstName"].stringValue,
                             middleName:    nil,
                             lastName:       JSONData["tabData"]["lastName"].stringValue)
    }
    var currency: Currency? {
        
        return .with(isoCode: JSONData["tabData"]["currency"].stringValue)
    }
    var amount: Decimal {
        
        return Decimal(JSONData["tabData"]["totalAmount"].doubleValue)
    }
    var postURL: URL? {
        
        return URL(string: "https://tap.company/post")
    }
    var paymentDescription: String? {
        
        return "";
    }
    var paymentMetadata: [String : String]? {
        
        return [:]
        
    }
    var paymentReference: Reference? {
        
        return Reference(transactionNumber: JSONData["tabData"]["incrementId"].stringValue,
                         orderNumber:       JSONData["tabData"]["orderId"].stringValue)
    }
    var paymentStatementDescriptor: String? {
        
        return "Payment statement descriptor will be here"
    }
    var require3DSecure: Bool {
        
        return true
    }
    var receiptSettings: Receipt? {
        
        return Receipt(email: true, sms: true)
    }
    var allowsToSaveSameCardMoreThanOnce: Bool {
        
        return false
    }
    var isSaveCardSwitchOnByDefault: Bool {
        
        return true
    }

var mode: TransactionMode {

return .purchase

}

var customer: Customer? {

return self.newCustomer

}

/// Creating a customer with known identifier received from Tap before.

var identifiedCustomer: Customer? {

return try? Customer(identifier: "cus_to_mer")

}

/// Creating a customer with raw information.

var newCustomer: Customer? {

let emailAddress = try! EmailAddress(emailAddressString: JSONData["tabData"]["customerEmail"].stringValue)

let phoneNumber = try! PhoneNumber(isdNumber: JSONData["tabData"]["countryCode"].stringValue, phoneNumber: JSONData["tabData"]["telephone"].stringValue)

return try? Customer(emailAddress: emailAddress,

phoneNumber: phoneNumber,

firstName: JSONData["tabData"]["firstName"].stringValue,

middleName: nil,

lastName: JSONData["tabData"]["lastName"].stringValue)

}

var currency: Currency? {

return .with(isoCode: JSONData["tabData"]["currency"].stringValue)

}

var amount: Decimal {

return Decimal(JSONData["tabData"]["totalAmount"].doubleValue)

}

var postURL: URL? {

return URL(string: "https://tap.company/post")

}

var paymentDescription: String? {

return "";

}

var paymentMetadata: [String : String]? {

return [:]

}

var paymentReference: Reference? {

return Reference(transactionNumber: JSONData["tabData"]["incrementId"].stringValue,

orderNumber: JSONData["tabData"]["orderId"].stringValue)

}

var paymentStatementDescriptor: String? {

return "Payment statement descriptor will be here"

}

var require3DSecure: Bool {

return true

}

var receiptSettings: Receipt? {

return Receipt(email: true, sms: true)

}

var allowsToSaveSameCardMoreThanOnce: Bool {

return false

}

var isSaveCardSwitchOnByDefault: Bool {

return true

}

Step 5=> Handle payment success and failure

You can handle payment success and failure by adding paymentSucceed method and paymentFailed method.

    func paymentSucceed(_ charge: Charge, on session: SessionProtocol) {
        print(charge)
        
        self.dismiss(animated: true, completion: { self.callback?(charge.identifier,"1")})
        
        
        
    }
    func paymentFailed(with charge: Charge?, error: TapSDKError?, on session: SessionProtocol) {
        print(charge?.status ?? "")
        DispatchQueue.main.async{
            self.dismiss(animated: true, completion: {
                self.callback?(charge?.identifier ?? "0","0")
            })
        }
    }

func paymentSucceed(_ charge: Charge, on session: SessionProtocol) {

print(charge)

self.dismiss(animated: true, completion: { self.callback?(charge.identifier,"1")})

}

func paymentFailed(with charge: Charge?, error: TapSDKError?, on session: SessionProtocol) {

print(charge?.status ?? "")

DispatchQueue.main.async{

self.dismiss(animated: true, completion: {

self.callback?(charge?.identifier ?? "0","0")

})

}

Step 6 => Handle Session

You can handle Session by adding sessionHasStarted, sessionCancelled and sessionHasFailedToStart method.

    func sessionHasStarted(_ session: SessionProtocol) {
        print(session)
    }
    func sessionCancelled(_ session: SessionProtocol) {
        print(session)
        DispatchQueue.main.async{
            self.dismiss(animated: true, completion: {
                self.callback?("0","0")
            })
        }
        
    }
    func sessionHasFailedToStart(_ session: SessionProtocol) {
        print(session)
    }

func sessionHasStarted(_ session: SessionProtocol) {

print(session)

}

func sessionCancelled(_ session: SessionProtocol) {

print(session)

DispatchQueue.main.async{

self.dismiss(animated: true, completion: {

self.callback?("0","0")

})

}

func sessionHasFailedToStart(_ session: SessionProtocol) {

print(session)

}

Step 7 => Final Step

In viewDidload add the following code and call, updatePayButtonAmount and setData method

    override func viewDidLoad() {
        super.viewDidLoad()
        button.isEnabled = true
        button.delegate = self
        updatePayButtonAmount()
        self.button?.updateDisplayedState()
        self.title = "Tap Payment"
        setData()
    }

override func viewDidLoad() {

super.viewDidLoad()

button.isEnabled = true

button.delegate = self

updatePayButtonAmount()

self.button?.updateDisplayedState()

self.title = "Tap Payment"

setData()

}

   internal func updatePayButtonAmount() {
        
        self.button?.updateDisplayedState()
    }
    func setData(){
        print(JSONData)
        label.text = "Total Amount to pay ".localized+"\(Decimal(JSONData["tabData"]["totalAmount"].doubleValue))"
    internal func TabPaymentGatewayViewController() {
        
        self.button?.updateDisplayedState()
    }

internal func updatePayButtonAmount() {

self.button?.updateDisplayedState()

}

func setData(){

print(JSONData)

label.text = "Total Amount to pay ".localized+"\(Decimal(JSONData["tabData"]["totalAmount"].doubleValue))"

internal func TabPaymentGatewayViewController() {

self.button?.updateDisplayedState()

}

Note:-

(i)You can test the payment gateway using the Test key and Test card Number which you can get from below URL.

https://tappayments.api-docs.io/2.0/testing/test-api-keys

(ii) You have to also register the bundle identifier with the Tap support team.

Conclusion

So please follow the above step to integrate the Tap payment gateway and if you have any issue or suggestion you can leave your query/suggestion in the comment section.

Vicky Kumar 10 February 2020

. . .

6 comments

anand Jan 30, 2020 at 12:41 pm

how to configure button action to it and I’m not able to display the text in button-like KWD 10.000

i followed your steps and while clicking button nothing happens

Vicky Kumar (Moderator) Feb 10, 2020 at 7:39 pm
In viewDidload method you have to call updatePlayButtonAmount() and setData() method. You have to follow the final step (Step 7).

Reply

Mosin farooq May 23, 2021 at 12:48 pm

How to implement tap payment gateway in react native

anchit (Moderator) Sep 25, 2021 at 7:16 pm

check over here as per the official git hub repo –> https://github.com/Tap-Payments/gosellSDK-ReactNative

Reply

Bhargav Joshi Jun 15, 2021 at 11:46 am

TAP API SDK ERROR
Errors detected on the backend:
Error ErrorCode: Invalid API Key

Error show on console.

Vicky Kumar (Moderator) Sep 27, 2021 at 7:17 pm
Please also verify that you are using the correct secret keyhttps://tappayments.api-docs.io/2.0/testing/test-api-keys

Reply

Tap Payment Gateway Integration In Swift With SDK

Step to Integrate Tap Payment Gateway

Step 1 => Add ‘goSellSdk’ in the project

Step 2 => Setup of SDK

Step 3 => Setup of Play Button

Step 4 => Implementing SessionDataSource and SessionDelegate

Step 5=> Handle payment success and failure

Step 6 => Handle Session

Step 7 => Final Step

Conclusion

Leave a Comment Cancel Reply

6 comments

Tap Payment Gateway Integration In Swift With SDK

Step to Integrate Tap Payment Gateway

Step 1 => Add ‘goSellSdk’ in the project

Step 2 => Setup of SDK

Step 3 => Setup of Play Button

Step 4 => Implementing SessionDataSource and SessionDelegate

Step 5=> Handle payment success and failure

Step 6 => Handle Session

Step 7 => Final Step

Conclusion

Leave a Comment Cancel Reply

6 comments

Message Sent!