Accept EPS with server-side-only integration

Build your own payment form to add EPS payment to your checkout page.

Overview

EPS payment method doesn’t require any input from the customer on the merchant website. Optionally you can include a bank selection control for the customer to pre-select their bank when making the payment. You can see an example of EPS bank selection component on our demo page.

Before you begin

Step 1: Create a Payment Type resource [server side]

Data for the EPS payment:

Payment data Description
bic [optional] The BIC of the bank selected by the customer

Banks supported by EPS:

Bank name BIC code
Production banks
Erste Bank und Sparkassen GIBAATWGXXX
HYPO NOE LB für Niederösterreich u. Wien HYPNATWWXXX
Austrian Anadi Bank AG HAABAT2KXXX
Ärzte- und Apothekerbank BWFBATW1XXX
VR-Bank Braunau VRBKAT21XXX
Hypo Tirol Bank AG HYPTAT22XXX
Bankhaus Carl Spängler & Co.AG SPAEAT2SXXX
Bankhaus Schelhammer & Schattera AG BSSWATWWXXX
Hypo Vorarlberg Bank AG HYPVAT2BXXX
BAWAG P.S.K. AG BAWAATWWXXX
Easybank AG EASYATW1XXX
Sparda-Bank Wien SPADATW1XXX
Volksbank Gruppe VBOEATWWXXX
Schoellerbank AG SCHOATWWXXX
Bank Austria BKAUATWWXXX
HYPO-BANK BURGENLAND Aktiengesellschaft EHBBAT2EXXX
HYPO Oberösterreich,Salzburg,Steiermark OBLAAT2LXXX
Oberbank AG OBKLAT2LXXX
Volkskreditbank AG VKBLAT2LXXX
BTV VIER LÄNDER BANK BTVAAT22XXX
BKS Bank AG BFKKAT2KXXX
Hypo Alpe-Adria-Bank International AG HAABAT22XXX
Raiffeisen Bankengruppe Österreich RANMAT21XXX
Dolomitenbank OVLIAT21XXX
Capital Bank Grawe Gruppe AG RSBUAT2KXXX
Brüll Kallmus Bank AG SPBAATWWXXX
Marchfelder Bank MVOGAT22XXX
Sandbox bank
___________

___________
Stuzza STZZATWWXXX

When creating the payment type EPS, you need to send a request to the Unzer API. The response contains an id , this is later referred to as typeId. You require this typeId to perform the transaction. As mentioned previously, bic is optional.


POST https://api.unzer.com/v1/types/eps

{
  "bic":"STZZATWWXXX"
}

// get the BIC from your payment form.
$unzer = new Unzer('s-priv-xxxxxxxxxx', SupportedLocale::GERMAN_GERMAN);
$eps= $unzer->createPaymentType((new EPS())->setBic($bic));

// get the BIC from your payment form.
Unzer Unzer = new Unzer("s-priv-xxxxxxxxxx");
EPS eps= heidelpayInstance.createPaymentType(new EPS(bic));

The response looks similar to the following example:


{
  "id": "s-eps-9rxdhskuhnea",
  "method": "EPS",
  "recurring": false,
  "geoLocation": {
    "clientIp": "127.0.0.1",
    "countryCode": "DE"
  },
  "bic": "STZZATWWXXX"
}

For a full description of EPS payment type creation, check API reference.

Next steps

The next steps are the same as for the UI components integration, check Accept EPS with UI Components from Step 2 onwards