Payment-method icon

Online banking Finland Redirect Component

Add Online banking Finland to your existing iOS Components integration.

This page explains how to add Online banking Finland to your existing iOS Components integration.

Requirements

Requirement Description
Integration type Make sure that you have built your iOS Components integration.
Setup steps Before you begin, add Online banking Finland in your test Customer Area.

API reference

Select which endpoint you are using:

This is the default with Components v5.0.0 or later.

Parameter name Required Description
shopperEmail -white_check_mark- The shopper's email address.

For a full list of optional fields that you can send for all payment methods, see /sessions.

Expand view
Copy link to code block
Copy code
Copy code
curl https://checkout-test.adyen.com/checkout/v69/sessions \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
  "merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
  "reference": "YOUR_ORDER_NUMBER",
  "paymentMethod": {
    "type": "ebanking_FI"
  },
  "amount": {
    "currency": "EUR",
    "value": "1000"
  },
  "shopperLocale": "fi_FI",
  "countryCode": "FI",
  "telephoneNumber": "+358840839298",
  "shopperEmail": "youremail@email.com",
  "shopperName": {
    "firstName": "Testperson-fi",
    "lastName": "Approved"
  },
  "shopperReference": "YOUR_UNIQUE_SHOPPER_ID",
  "returnUrl": "https://your-company.com/checkout?shopperOrder=12xy.."
}'

Component configuration

v5.0.0 or later

If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Online banking Finland Component:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
let paymentMethods = session.sessionContext.paymentMethods
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("ebanking_FI")) else { return }
let component = InstantPaymentComponent(paymentMethod: paymentMethod,
                                        context: context,
                                        order: nil)
self.currentComponent = component
// Set the session as the delegate.
component.delegate = session
component.initiatePayment()

v4.x.x

If your integration uses an earlier version of iOS Components:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: OnlineBankingPaymentMethod.self) else { return }
let style = FormComponentStyle()
let component = OnlineBankingComponent(paymentMethod: paymentMethod,
                                apiContext: context,
                                style: style)
present(component)

There are no configuration steps specific to Online banking Finland required for Components.

Test and go live

Before accepting live payments, test your integration using the test environment and sample data provided by Paytrail.

Testing multiple partial refunds is currently not available.

See also