Accept Giropay with server-side-only integration

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


Giropay payment method doesn’t require any input from the customer on the merchant website. The customer will specify the required payment information on the Giropay website.

Before you begin

Step 1: Create a Payment Type resource
server side

When creating the payment type Giropay, you need to send a request to the Unzer API. The response will contain an id , this is later referred to as typeId. You will need this typeId to perform the transaction.

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

$unzer = new Unzer('s-priv-xxxxxxxxxx', SupportedLocale::GERMAN_GERMAN);
$Giropay = $unzer->createPaymentType(new Giropay());

Unzer Unzer = new Unzer(new HttpClientBasedRestCommunication(), "s-priv-xxxxxxxxxx");
Giropay Giropay = new Giropay();
giropay = unzer.createPaymentType(giropay);

The response looks similar to the following example:

  "id": "s-Giropay-9rxdhskuhnea",
  "method": "Giropay",
  "recurring": false,
  "geoLocation": {
    "clientIp": "",
    "countryCode": "DE"
  "bic": "STZZATWWXXX"

For more details on iDeal payment type creation, see API reference.

Next steps

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