No momento, esta página não está disponível em português
Payment-method icon

Online banking Slovakia for API only

Add Online banking Slovakia to your API-only integration.

You can add Online banking Slovakia to your existing integration. The following instructions show only what you must add to your integration specifically for Online banking Slovakia.

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.

Requirements

Requirement Description
Integration type Make sure that you have an existing API-only integration.
This page includes only instructions to add Online banking Slovakia to your existing integration.
Redirect handling Make sure that your existing integration is set up to handle the redirect.
action.type: redirect
Setup steps Before you begin, add Online banking Slovakia in your Customer Area.

Get Online banking Slovakia as an available payment method

When you make the /paymentMethods to get available payment methods, specify the following so that Online banking Slovakia is included in the response.

Parameter Values
countryCode SK
amount.currency EUR

Build your payment form for Online banking Slovakia

We provide the logo for Online banking Slovakia that you can download.

Your payment form for Online banking Slovakia does the following:

  1. Show a list of available issuing banks to your shopper. You can get the list of available issuing banks from the /paymentMethods response, in the object with type: onlineBanking_SK.

  2. When the shopper selects a bank, pass the corresponding Issuer ID value to your server.

    Online banking Slovakia supports the following banks.

    Bank name Issuer ID
    BLIK SK bliksk
    ePlatby VÚB vub
    Poštová banka posta
    Sporopay sporo
    TatraPay tatra
    Viamo viamo

  3. Ask the shopper to accept Online banking Slovakia terms and conditions.

Add additional parameters to your /payments request

When you make a payment, add the following parameters:

Parameter Required Description
paymentMethod.issuer -white_check_mark- The issuing bank that the shopper selected.
Example request
Expand view
Copy link to code block
Copy code
Copy code
curl https://checkout-test.adyen.com/checkout/v71/payments \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
  "merchantAccount":"ADYEN_MERCHANT_ACCOUNT",
  "reference":"YOUR_ORDER_NUMBER",
  "amount":{
    "currency":"EUR",
    "value":1000
  },
  "paymentMethod":{
    "type":"onlineBanking_SK",
    "issuer":"vub"
  },
  "returnUrl":"https://your-company.com/checkout?shopperOrder=12xy.."
}'

Handle the additional action

You must handle the additional action for Online banking Slovakia.

The action.type is redirect.

Test and go live

Test Online banking Slovakia payments with real payment details and small amounts.

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

To accept live Online banking Slovakia payments, add it as a payment method in your Customer Area.

See also