This page explains how to add Online banking Czech Republic to your existing Components integration.
Requirements
Select the server-side flow that your integration uses:
Import resources for v6
If you are using Web Components v6, import the Component that you need for Online banking Czech Republic:
import { AdyenCheckout, OnlineBankingCZ } from '@adyen/adyen-web'
API reference
You do not need to send additional fields for Online banking Czech Republic. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:
- /sessions: This is the default with Components v5.0.0 or later.
- /payments: If you implemented an additional use case.
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="onlineBanking_CZ-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
.
const onlineBanking_CZ = new OnlineBankingCZ(checkout).mount('#onlineBanking_CZ-container');
v5.x.x or earlier
Use the create
method of your AdyenCheckout
instance, in this case checkout
, to create the Component:
const onlineBanking_CZComponent = checkout.create('onlineBanking_CZ').mount('#onlineBanking_CZ-container');
Optional configuration
You can add the following optional configuration:
Parameter name | Description | Default |
---|---|---|
showImage |
Set to false to remove the bank logos from the Online banking Czech Republic form. | true |
issuer |
Set to an Online banking Czech Republic issuer ID to preselect a specific bank. | No bank is preselected. |
highlightedIssuers |
Set to the Online banking Czech Republic issuer IDs for banks you want to show on top of the dropdown menu. Added in v5.22.0 | All issuers are shown in the dropdown. |
placeholder |
The string you want to show as the dropdown menu text. Custom translation configuration overrides this value. | Select your bank |
If you want to add optional configuration, include this in a configuration object. The following example shows how to configure the Online banking Czech Republic Component to remove the bank logos, and preselect Česká spořitelna:
const onlineBanking_CZConfiguration = {
showImage: false, // Optional. Set to **false** to remove the bank logos from the Online banking Czech Republic form.
issuer: "cs" // Optional. Set this to an **id** of an Online banking Czech Republic issuer to preselect it.
};
v6.0.0 or later
Create an instance of the Component, passing:
- Your instance of
AdyenCheckout
. - The payment method-specific configuration.
const onlineBanking_CZ = new OnlineBankingCZ(checkout, onlineBanking_CZConfiguration).mount('#onlineBanking_CZ-container');
v5.x.x or earlier
Use the create
method of your AdyenCheckout
instance, in this case checkout
, to create an instance of the Component. Add the configuration object if you created one.
const onlineBanking_CZComponent = checkout.create('onlineBanking_CZ', onlineBanking_CZConfiguration).mount('#onlineBanking_CZ-container');
List of issuer IDs
Bank name | Issuer ID |
---|---|
Česká spořitelna | cs |
Komercní banka | kb |
mTransfer | mp |
Fio banka | pf |
Moneta Money Bank | pg |
Raiffeisenbank ePlatby | rf |
Test and go live
Test Online banking Czech Republic payments with real payment details and small amounts.
Check the status of your test Online banking Czech Republic payments in your Customer Area > Transactions > Payments.
To accept live Online banking Czech Republic payments, add it as a payment method in your Customer Area.