FIBConfiguration.plistOverview:

1. accountId: this isaccountIdof the FIB business account which receives the payments.
2. clientSecret: an secret that you will be given to authenticate you.
3. clientId: an Id that you will be given to identify you as a client.
4. grantType: this is used for authentication as well.
5. baseURLs: thebaseURLs that we use for making the API requests for creating the payment, currently it only has one property which is fibPayGate.

The fibPayGate can be either:

1. Develop: which can be used for testing purposes.

   Code Example

   https://fib.stage.fib.iq

2. production: which you will use when you release your app.

   Code Example

   https://fib.prod.fib.iq

To use the FIBPaymentSDK you need to import:

import FIBPaymentSDK

Then you will need to create an instance of PayWithFIBView:

let fibView = PayWithFIBView()

PayWithFIBView has three methods:

1. Configure: which you can call to make the view intractable.

   Code Example

   configure(fibApplicationURLs: [FIBApplicationURLType], delegate: FIBPaymentManagerDelegate?)

   Configure has two parameters.

   • fibApplicationURLs: this is an Array of TypeFIBApplicationURLType, so we expect all the links of the FIB apps to be sent to this method.
   • delegate:it is an instance of typeFIBPaymentManagerDelegate?which you need conform in order to be notified about some extra information on the transaction.
   FIBPaymentManagerDelegatehas two methods which you can implement:
   • paymentCanceled:this one is called when you cancel a specific payment.

     Code Example

     func paymentCanceled(paymentID: String):

   • didReceive:This one will be called every time you want to start a FIB payment or check the status of a specific payment but an error occurs in the APIRequest for handling these cases you will need to implement this to deal with anyerror that might occur.

     Code Example

     func didReceive(error: APIError):

     The error is of typeAPIError which is anenum so that you can check what is exactly the error and update you UI accordingly. Doing so you enable thefibView to make all the required functionalities and present and alert to indicate to the user that he/she can open the available FIB applications.

2. checkPaymentStatus:It is another method ofPayWithFIBView will be used to check the status of a specific payment.

   Code Example

   public func checkPaymentStatus(paymentID: String, completion: @escaping (PaymentStatusType?) -> Void)

   checkPaymentStatus has two parameters:
   • paymentID: an ID which is used to indicate which transaction you need to check.
   • completion: which gives you feedback about the status.

3. cancelPayment: It is another method of PayWithFIBView will be used to cancel a specific payment.

   Code Example

   func cancelPayment(paymentID: String)

   Note: Please note that Cancel Payment feature should not be used for refunding an item, this feature should be used only to cancel a pending and currently active payment.

   PayWithFIBView has an instance of UIButton which you can customize for example like that:

   Code Example

   fibView.button.setTitle( "any custom title", for: .normal)

   Using Your Own UI: you can assign the logic for handling payment with FIB your self, Incase you want to use the SDK but you want to use your won UI, we got your back.

   we have created a class which you can use to handle all the logic but provide your own UI:

   Code Example

   let fibPaymentManager: FIBPaymentManagerType
                                           init(fibPaymentManager: FIBPaymentManagerType = FIBPaymentManager()) {
                                           self.fibPaymentManager = fibPaymentManager
                                           fibPaymentManager.delegate = self
                                           }

   As you seeFIBPaymentManagerType is a protocol and FIBPaymentManageris the class that conforms to it, we have provided this protocol in order to make your life easier in terms of testability.

   It has three methods which you will need to use:

   1. openFIB: This is responsible for opening the fib apps based on you input:

      Code Example

      func openFIB(_ applicationType: FIBApplicationURLType)

      it has one parameter which isapplicationType : you can pass.personalURL("personal app link")or.businessURL("business app link")or,.corporateURL("corporate app link"), based on user’s input to you.

   2. checkPaymentStatus: this one is used to check the status of a specific payment.

      Code Example

      func checkPaymentStatus(paymentID: String, completion: @escaping ((PaymentStatusType?) -> Void))

      It has two Parameters:
      • paymentID: an ID which is used to indicate which transaction you need to check.
      • completion:which gives you feedback about the status.

   3. cancelPayment: you call this one when you want to cancel a specific payment.

      Code Example

      func cancelPayment(paymentID: String)

      As you can see in the body of theinitializer,fibPaymentManagerhas a property calleddelegate and it is of typeFIBPaymentManagerDelegate?Which you need to conform to and implement its methods.