giropay

giropay transactions can also be processed via the Saferpay JSON API. However, as giropay is a third party provider, there are a few things to consider.

General requirements

• A corresponding license and thus a valid identification with a username and password for the Saferpay system.

• At least one active Saferpay terminal via which payment can be carried out and the associated Saferpay TerminalId.

• A valid giropay merchant account

• A valid Merchant Authorization Reference

For giropay activation on the Saferpay terminal, please inform our customer service about your giropay credentials and the desired currency.

Technical requirements

The general integration of giropay can only be done via the Payment Page and requires the following things to be noted:

• JSON API Version 1.5 or later

• giropay restricts the Payment.OrderId to a maximal length of 20 characters. The OrderId will be automatically trimmed if it exceeds the maximal length. Please keep this in mind to properly handle the use of the OrderId.

• giropay does not support the Iframe integration. Saferpay will break out of the IFrame, if necessary.

• The notification URLs, inside theNotification container are mandatory, in order to avoid missing payment successes. See the Payment Page process for further information.

Handling of delivery address

The processing of giropay transactions requires that the delivery address data is submitted. The minimum required delivery address values are:

• FirstName

• LastName

• Zip

• City

• CountryCode

If the minimum required delivery address values are submitted during the Payment Page initialization, the delivery address form will not be displayed or will be skipped, except if the DeliveryAddressForm value is set to true.

If the minimum required delivery data is missing or not complete, the Payment Page delivery address form, will be displayed during the payment process for the cardholder/purchaser to enter or complete the missing values. In this case the delivery address form is displayed regardless of the DeliveryAddressForm configuration (true or false).

Supported features

Feature	Support
Capture/Cancel	❌
Multipart Captures	❌
Secure Card Data	❌
Refunds	✅
Recurring Payments	❌
3D Secure	❌
Dynamic Currency Conversion	❌
Mail Phone Order	❌
Testing	✅
Omni-Channel	❌

giropay transactions (payments and refunds) are captured automatically and will always report:

Transaction.Status: "CAPTURED".

Testing

Please refer to this chapter, if you want to test giropay .