FawryPay iOS SDK

1. Import FawryPay SDK plugin in your Swift file.

                
                    import MyFawryPlugin
                
            

2. Initialize FawryPay services in your application class or your app entry point.

                
                    let FawryPlugin = Fawry.sharedInstance
                    FawryPlugin.initialize(
                                        serverURL: "https://fawry.com",
                                        styleParam: .style1,
                                        merchantIDParam: "9HEoTFmeTeI=",
                                        merchantRefNum: "AB123456789",
                                        languageParam: "en",
                                        GUIDParam: "#@DDFFEEER",
                                        customeParameterParam: nil,
                                        currancyParam: .EGP, items: T[Item]
                                     )
                
                

On the first line, we used shared instance to get the Framework main object. Hence that the common methodology to access the sdk object is by using the sharedInstance. Second line contains some parameters needed to initialize the SDK instance object, all of them are required.

Now It is time to add the SDK plugin FawryButton, there is a function in Fawry class named applyFawryButtonStyleToButton which apply FawryPay style Button to any UIButton instance.

                
                    @IBOutlet  weak var FawryPayButton: UIButton
                    .......
                    let FawryPlugin = Fawry.sharedInstance
                    FawryPlugin.applyFawryButtonStyleToButton(FawryPayButton)
                
            

Once you pass the button outlet, applyFawryButtonStyleToButton will inflate the button design as in the following image.

Or You can make your custom button by not calling the above function to design the button. Next step is to create an action method, let us say we will name it LaunchSdk within which we shall call show SDK function.

                
                    @IBOutlet  weak var FawryPayButton: UIButton
                    .........
                    let FawryPlugin = Fawry.sharedInstance
                    .........
                    @IBAction  func LaunchSdk(_ sender:Any){
                    FawryPlugin?.showSDK(onViewController: <#T##UIViewController#>>, completionBlock: <#T##(String?, FawryStatusCode) -> Void#>)
                    }
                
            

In your app, after collecting you user's cart, you will need to create a payment request

                
                    @IBAction  func initPaymentFlow(_ sender: Any) {
                        let FawryPlugin = Fawry.sharedInstance

                        var itemsList: [Item]!

                        itemsList = [Item]()
                        itemsList.append(Item(productSKUParam: "Item1", productDescriptionParam: "Item11", priceParam: 10, quantityParam: 1, widthParam: 1, heightParam: 1, lengthParam: 1, weightParam: 1))
                        /*===   Payment  ===*/
                        FawryPlugin?.initialize(
                            serverURL: "https://atfawry.fawrystaging.com",
                            styleParam: .style1,
                            merchantIDParam: "2n5QDrrCsUU=",
                            merchantRefNum: "MerchantRefNumValue",
                            languageParam: NSLocale.current.languageCode!,
                            GUIDParam: "#@DDFFEEER",
                            customeParameterParam: nil,
                            currancyParam: .EGP,
                            items: itemsList)


                        FawryPlugin?.showSDK(onViewController: self) { (transactionID, statusCode) in
                            if transactionID != nil {

                            }
                        }
                    }
                
            

In your app, after collecting you user's cart, you will need to create a payment request using card token.

                
                    @IBAction  func initTokenizerFlow(_ sender: Any) {
                        var cardTokenizerItem: CardTokenizerInfo!
                        let plugin = Fawry.sharedInstance

                        /*===   Card Token  ===*/

                                do{
                                    try plugin?.initializeCardTokenizer(serverURL: "https://atfawry.fawrystaging.com",
                                                                        styleParam: .style1,
                                                                        merchantIDParam: "2n5QDrrCsUU=",
                                                                        languageParam: NSLocale.current.languageCode!,
                                                                        GUIDParam: "#@DDFFEEER",
                                                                        customerMobileNumber: "01111615704",
                                                                        customerEmailAddress: "a@aa.com",
                                                                        customerProfileId: "7uyA76gf1",
                                                                        currancyParam: .EGP)

                                }catch (let errorMsg){
                                    print("error \(errorMsg.localizedDescription)")
                                }

                                plugin?.showSDK(onViewController: self) { (response, statusCode) in
                                    if response != nil {
                                        cardTokenizerItem = response as? CardTokenizerInfo
                                        let token = (cardTokenizerItem.card?.token)
                                        if ((token) != nil){
                                            print( "token : \(token ?? "")")
                                        }
                                    }
                                }
                    }
                
            

You need to cast the AnyObject to Framwork exposed object CardTokenizerInfo which contain the following:

You can use below callback methods which will be triggered when payment operation has succeeded or failed before user click done in receipt screen.

                
                    FawryPlugin?.paymentOperationSuccess(onViewController: self) { (transactionID, statusCode) in
                        if transactionID != nil {
                            print("Transaction ID = \(transactionID ?? "" as AnyObject)")
                        }
                    }
                    FawryPlugin?.paymentOperationFailure(onViewController: self) { (transactionID, statusCode) in
                    print("payment Operation Failure")
                    }
                
            

The showSDK method will return the result in a completionBlock which will contains two parameters transactionID (fawry order number) and statusCode. In case of error, the transactionID will be nil. Kindly find the list of FawryPay enums status codes below.