On this page, you can find additional configuration for adding Online banking Poland to your Components integration.
Before you begin
This page assumes you've already:
API reference
You don't need to send additional fields for Online banking Poland. 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 advanced use case, or integrated Components before v5.0.0.
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="dotpay-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 dotpayComponent = checkout.create('dotpay').mount('#dotpay-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 Poland form. | true |
issuer |
Set to a Online banking Poland issuer ID to preselect a specific bank. | No bank is preselected. |
highlightedIssuers |
Set to the Online banking Poland issuer IDs for banks you want to show on top of the dropdown menu. Added in v5.1.0 | All issuers are shown in the dropdown. |
placeholder |
String to show for 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 Component to remove the bank logos, and preselect Banki Spółdzielcze:
const dotpayConfiguration = {
showImage: false, // Optional. Set to **false** to remove the bank logos from the Online banking Poland form.
issuer: "74" // Optional. Set this to an **id** of an Online banking Poland issuer to preselect it.
};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 dotpayComponent = checkout.create('dotpay', dotpayConfiguration).mount('#dotpay-container');Test and go live
Before accepting live Online banking Poland payments, test your integration using test.adyen.com endpoints in your test environment.
Once you send a test payments request, you'll be redirected to Dotpay. You need to enter your name and email in order to receive confirmation from Dotpay. You don't need any specific test credentials to do test payments.
Check the status of Dotpay test payments in your Customer Area > Transactions > Payments.
Before you can accept live Online banking Poland payments, you need to submit a request for Dotpay in your live Customer Area.