Online banking Finland Component

Add Online banking Finland to an existing Components integration.

On this page, you can find additional configuration for adding Online banking Finland to your Components integration.

Before you begin

This page assumes you have already:

API reference

Select which endpoint you're integrating:

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

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

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

curl https://checkout-test.adyen.com/v69/sessions \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "merchantAccount": "YOUR_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.."
}'

https://docs.adyen.com/payment-methods/finland-online-banking/web-component#finland-online-banking-sessions

Component configuration

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

 <div id="ebanking_FI-container"></div>

Step 2: Create an instance of the Component

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

const ebankingFiComponent = checkout.create('ebanking_FI').mount('#ebanking_FI-container');

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.