Online banking Poland Drop-in integration

Add Online banking Poland to your existing iOS Drop-in integration.

On this page, you can find additional configuration for adding Online banking Poland to your Drop-in integration.

Before you begin

This page assumes you've already:

API reference

Select which endpoint you're integrating:

This is the default with Drop-in v5.0.0 or later.

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

If you implemented an advanced use case, or integrated Drop-in before v5.0.0.

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

curl https://checkout-test.adyen.com/v68/payments \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
  "reference":"YOUR_ORDER_NUMBER",
  "amount":{
    "currency":"PLN",
    "value":1000
  },
  "shopperEmail":"s.hopper@example.com",
  "{hint:state.data.paymentMethod from onSubmit}paymentMethod{/hint}":{
    "type":"onlineBanking_PL"
  },
  "returnUrl":"https://your-company.com/checkout?shopperOrder=12xy..",
}'

# Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen::Client.new
adyen.api_key = "YOUR_X-API-KEY"
 
response = adyen.checkout.payments({
  :amount => {
    :currency => "PLN",
    :value => 1000
  },
  :reference => "YOUR_ORDER_NUMBER",
  :paymentMethod => {
    :type => "onlineBanking_PL"
  },
  :returnUrl => "https://your-company.com/checkout?shopperOrder=12xy..",
  :merchantAccount => "YOUR_MERCHANT_ACCOUNT",
  :shopperEmail => "s.hopper@example.com"
})

// Set YOUR_X-API-KEY with the API key from the Customer Area.
// Change to Environment.LIVE and add the Live URL prefix when you're ready to accept live payments.
    Client client = new Client("YOUR_X-API-KEY", Environment.TEST);
    Checkout checkout = new Checkout(client);

    PaymentsRequest paymentsRequest = new PaymentsRequest();

    String merchantAccount = "YOUR_MERCHANT_ACCOUNT";
    paymentsRequest.setMerchantAccount(merchantAccount);

    Amount amount = new Amount();
    amount.setCurrency("PLN");
    amount.setValue(15000L);
    paymentsRequest.setAmount(amount);

    DefaultPaymentMethodDetails paymentMethodDetails = new DefaultPaymentMethodDetails();
    paymentMethodDetails.setType("onlineBanking_PL");
    paymentsRequest.setPaymentMethod(paymentMethodDetails);

    paymentsRequest.setReference("YOUR_ORDER_NUMBER");
    paymentsRequest.setReturnUrl("https://your-company.com/checkout?shopperOrder=12xy..");
    paymentsRequest.setShopperEmail("s.hopper@example.com");

    PaymentsResponse paymentsResponse = checkout.payments(paymentsRequest);

// Set your X-API-KEY with the API key from the Customer Area.
$client = new \Adyen\Client();
$client->setXApiKey("YOUR_X-API-KEY");
$service = new \Adyen\Service\Checkout($client);

$params = array(
  "amount" => array(
    "currency" => "PLN",
    "value" => 1000
  ),
  "reference" => "YOUR_ORDER_NUMBER",
  "paymentMethod" => array(
    "type" => "onlineBanking_PL"
  ),
  "returnUrl" => "https://your-company.com/checkout?shopperOrder=12xy..",
  "merchantAccount" => "YOUR_MERCHANT_ACCOUNT",
  "shopperEmail" => "s.hopper@example.com"
);
$result = $service->payments($params);

#Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen.Adyen()
adyen.client.xapikey = 'YOUR_X-API-KEY'

result = adyen.checkout.payments({
   'amount': {
      'value': 1000,
      'currency': 'PLN'
   },
   'reference': 'YOUR_ORDER_NUMBER',
   'paymentMethod': {
      'type': "onlineBanking_PL"
   },
   'returnUrl': "https://your-company.com/checkout?shopperOrder=12xy..",
   'merchantAccount': 'YOUR_MERCHANT_ACCOUNT'
})

// Set your X-API-KEY with the API key from the Customer Area.
var client = new Client ("YOUR_X-API-KEY", Environment.Test);
var checkout = new Checkout(client);

var amount = new Model.Checkout.Amount("PLN", 1000);
var details = new Model.Checkout.DefaultPaymentMethodDetails{
  Type = "onlineBanking_PL",
};
var paymentRequest = new Adyen.Model.Checkout.PaymentRequest
{
  Reference = "YOUR_ORDER_NUMBER",
  Amount = amount,
  ReturnUrl = @"https://your-company.com/checkout?shopperOrder=12xy..",
  MerchantAccount = "YOUR_MERCHANT_ACCOUNT",
  PaymentMethod = details,
  shopperEmail = "s.hopper@example.com"
};

var paymentResponse = checkout.Payments(paymentsRequest);

// Set your X-API-KEY with the API key from the Customer Area.
const {Client, Config, CheckoutAPI} = require('@adyen/api-library');
const config = new Config();
// Set your X-API-KEY with the API key from the Customer Area.
config.apiKey = '[API_KEY]';
config.merchantAccount = '[YOUR_MERCHANT_ACCOUNT]';
const client = new Client({ config });
client.setEnvironment("TEST");
const checkout = new CheckoutAPI(client);
checkout.payments({
    amount: { currency: "PLN", value: 1000 },
    paymentMethod: {
        type: "onlineBanking_PL"
    },
    reference: "YOUR_ORDER_NUMBER",
    merchantAccount: config.merchantAccount,
    returnUrl: "https://your-company.com/checkout?shopperOrder=12xy..",
    shopperEmail: "s.hopper@example.com"
}).then(res => res);

https://docs.adyen.com/payment-methods/online-banking-poland/web-drop-in#onlinebanking-pl-payments

Drop-in configuration

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

//Create a payment method object for Online banking Poland.
let paymentMethod = paymentMethods.paymentMethod(ofType: onlineBanking_PLComponentPaymentMethod.self)
//Create a configuration object for the Online banking Poland Component.
var onlineBanking_PLComponentConfiguration = onlineBanking_PLComponent.Configuration()
//Set additional parameters on the configuration object.
onlineBanking_PLComponentConfiguration.localizationParameters = //Optional custom localization parameters.

There is no required Online banking Poland specific integration for Components.

Test and go live

Check the status of Online banking Poland test payments in your Customer Area > Transactions > Payments.

Before you can accept live Online banking Poland payments, you need to submit a request for Online banking Poland in your live Customer Area.

Are you looking for test card numbers?

Would you like to contact support?

Online banking Poland Drop-in integration

Before you begin

API reference

Drop-in configuration

Test and go live

See also