Payment-method icon

Online banking Finland Component

Add Online banking Finland to an existing Components integration.

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

Requirements

Select the server-side flow that your integration uses:

Requirement Description
Integration type Make sure that you have built a Sessions flow Web Components integration.
Setup steps Before you begin, add Online banking Finland in your 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/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

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:

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

Step 2: Create an instance of the Component

v6.0.0 or later

Create an instance of the Component, passing:

  • Your instance of AdyenCheckout.
Copy code
const ebankingFi = new Redirect(checkout, { type: 'ebanking_FI' }).mount('#ebanking_FI-container');

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

Copy code
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.

See also