Adding Klarna Payments to Your App

Adding Klarna Payments to your application is as easy as adding a view and performing a few operations on it. You can read more about the flow here .

This guide will teach you how to:

• Render a Payment View
• Operate on a payment method via its Payment View.

We expose six methods on the payment view that you can use to interact with the payment method it’s presenting:

Before content is rendered into a payment view, it needs to be configured. You can do this by initializing the view.

After the view has been added and set up, you’ll need to call initialize() with the clientToken you received from the back-end and a returnURL.

1
paymentView.initialize(clientToken: clientToken, returnUrl: returnUrl)

If successful, klarnaInitialized() will be called in the listener you supplied. If it’s not successful klarnaFailed() will be called instead.

1
2
3
func klarnaInitialized(paymentView: KlarnaPaymentView) {
    klarnaPaymentView.load()
}

Once you’ve initialized the view and you’re ready to display the KlarnaPaymentView.

Simply call load(), supplying an optional string with updated order data to update the session. This string should be formatted as valid JSON.

1
klarnaPaymentView.load()

If successful, klarnaLoaded() will be called in your listener. If anything went wrong, klarnaFailed() will be called. If you’ve loaded several views, you should keep track of which view your user selected to know what to authorize in the next step.

1
2
3
func klarnaLoaded(paymentView: KlarnaPaymentView) {
    // Content has finished loading and if you have any loader you could hide it here.
}

When the payment view is loaded, and the user has confirmed that they want to pay with one of Klarna’s selected payment methods, it’s time to authorize the session.

When you are ready to authorize the session, call authorize(). As with load, you can supply an optional string to update the session. You can also specify whether auto-finalization should be turned off; if it is, the user may need to be prompted a second time to input data.

1
paymentView.authorize()

If successful, klarnaAuthorized() will be called in your listener. If not, klarnaFailed() will be called.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
func klarnaAuthorized(paymentView: KlarnaPaymentView, approved: Bool, authToken: String?, finalizeRequired: Bool) {
    if approved == true {
        // the authorization was successful
    } else {
        // user is not approved or might require finalization
    }

    if let token = authToken {
        // authorization is successful, backend may create order
    }

    if finalizedRequired == true {
        // app needs to call finalize()
    }
}

There are cases when you might want to allow your customer to change their order after it has been authorized (e.g. in some form of order/summary view). In these cases, if the order or customer details have changed, you’ll need to reauthorize the session.

1
paymentView.reauthorize()

If successful, klarnaReauthorized() will be called, and if not, klarnaFailed() will be called instead.

1
2
3
4
5
6
7
8
9
10
11
func klarnaReauthorized(paymentView: KlarnaPaymentView, approved: Bool, authToken: String?) {
    if approved == true {
        // the reauthorization was successful
    } else {
        // user is not approved or might require finalization
    }

    if let token = authToken {
        // reauthorization is successful, backend may create order
    }
}

If the session needs to be finalized, you’ll need to perform this last step to get an authorization token.

Call finalise() in order to get the token.

1
paymentView.finalise()

If successful, klarnaFinalized() will be called in your listener. If not successful, klarnaFailed() will be called.

1
2
3
4
5
6
7
8
9
10
11
func klarnaFinalized(paymentView: KlarnaPaymentView, approved: Bool, authToken: String?) {
    if approved == true {
        // the finalization was successful
    } else {
        // user is not approved or might require finalization
    }

    if let token = authToken {
        // finalization is successful, backend may create order
    }
}

If you’d like to allow the user to review their payment after it’s authorized, this can be done in two ways:

1. Render it in a new view:

   • Create a new KlarnaPaymentView with the same payment method
   • Call initialize()
   • Call then loadPaymentReview()

2. Render it in the existing payment view:

   • Call loadPaymentReview() in the existing view.

This will load/replace the view’s content with a description of how your customer will have to perform payment.

1
paymentView.loadPaymentReview()

If successful klarnaLoadedPaymentReview() will be called in your listener. If not, klarnaFailed() will be called instead.

1
2
3
func klarnaLoadedPaymentReview(paymentView: KlarnaPaymentView) {
    // Payment review loaded
}

This will handle all the errors from the previous implementations. KlarnaPaymentError will contain the information needed to show to the user and also to handle all the states of the listener.

1
2
3
func klarnaFailed(inPaymentView paymentView: KlarnaPaymentView, withError error: KlarnaPaymentError) {
    // handle error
}