Configuration

While making a payment, the SDK will need to create a payment order, and possibly start a consumer identification session. These are ultimately done using the relevant Swedbank Pay APIs, but as those are protected by secrets you cannot securely embed in a mobile app, you will need our own server in the middle.

The SDK cannot communicate directly with your servers, so you must provide a Configuration that specifies how it does that. This page provides a basic overview of the Configuration on both iOS and Android. More details shall be discussed in the platform-specific chapters.

iOS

The Configuration is a value that conforms to the SwedbankPaySDKConfiguration protocol. The protocol has two required methods:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

    struct MyConfiguration : SwedbankPaySDKConfiguration {

        // This method is called when the SDK starts a consumer identification session.
        // You need to make a request to your own backend here, that backend must
        // make a POST /psp/consumers request to Swedbank Pay, finally you must propagate
        // the result of that request to the completion callback here.
        //
        // The consumer and userData arguments are the values set to your
        // SwedbankPaySDKController. Their precise meaning is up to you.
        func postConsumers(
            consumer: SwedbankPaySDK.Consumer?,
            userData: Any?,
            completion: @escaping (Result<SwedbankPaySDK.ViewConsumerIdentificationInfo, Error>) -> Void
        ) {
           // code
        }

        // This method is called when the SDK creates the payment order.
        // You need to make a request to your own backend here, that backend must
        // make a POST /psp/paymentorders request to Swedbank Pay, finally you must propagate
        // the result of that request to the completion callback here.
        //
        // The paymentOrder and userData arguments are the values set to your
        // SwedbankPaySDKController. Their precise meaning is up to you.
        //
        // If you are making a payment with consumer identification, then the
        // consumerProfileRef from the identification session will be provided
        // in the consumerProfileRef argument. Otherwise, consumerProfileRef will be nil.
        func postPaymentorders(
            paymentOrder: SwedbankPaySDK.PaymentOrder?,
            userData: Any?,
            consumerProfileRef: String?,
            completion: @escaping (Result<SwedbankPaySDK.ViewPaymentOrderInfo, Error>) -> Void
        ) {
           // code
        }
    }

Android

The Configuration is a subclass of the abstract class Configuration. The class has two abstract methods. These methods are suspending (asynchronous) Kotlin methods; a compatibility class is provided if you need to implement your Configuration in Java instead.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

    class MyConfiguration : Configuration() {

        // This method is called when the SDK starts a consumer identification session.
        // You need to make a request to your own backend here, that backend must
        // make a POST /psp/consumers request to Swedbank Pay, and finally you must
        // return a ViewConsumerIdentificationInfo object populated with the
        // results of that request.
        //
        // The context argument is an application context for resource access.
        // The consumer and userData arguments are the values set as arguments
        // to PaymentFragment. Their precise meaning is up to you.
        override suspend fun postConsumers(
            context: Context,
            consumer: Consumer?,
            userData: Any?
        ): ViewConsumerIdentificationInfo {
            // code
        }

        // This method is called when the SDK creates the payment order.
        // You need to make a request to your own backend here, that backend must
        // make a POST /psp/paymentorders request to Swedbank Pay, finally you must
        // return a ViewPaymentOrderInfo object populated with the
        // results of that request.
        //
        // The context argument is an application context for resource access.
        // The paymentOrder and userData arguments are the values set as arguments
        // to PaymentFragment. Their precise meaning is up to you.
        //
        // If you are making a payment with consumer identification, then the
        // consumerProfileRef from the identification session will be provided
        // in the consumerProfileRef argument. Otherwise, consumerProfileRef will be nil.
        override suspend fun postPaymentorders(
            context: Context,
            paymentOrder: PaymentOrder?,
            userData: Any?,
            consumerProfileRef: String?
        ): ViewPaymentOrderInfo {
            // code
        }
    }

Backend

As the mobile application cannot talk directly to Swedbank Pay servers, you will need your own backend to make those requests on the behalf of your Configuration. You are free to design your backend as best suits you, but there is also a chapter that will detail one possible example implementation, which also has a bundled-in Configuration implementation available in the SDK.

One thing you should keep in mind while designing your backend is that the paymentUrl of your payment order needs special consideration in order to work correctly. This is a somewhat complicated issue, discussed in detail in each platform-specific chapter, but the gist of the issue is that the paymentUrl will, in some cases, be opened in the browser application, and at that point we must take some measures to return to your application to continue the payment. This can be accomplished by having paymentUrl return a redirect response; the details of that redirect will be discussed in the platform-specific pages. It is recommended that paymentUrl be unique to each payment order that you create.

The next chapter will go over a custom backend implementation. It will also detail how paymentUrl should be handled.