About giropay

General information about giropay

giropay is a standard founded by the German banks Sparkasse, Postbank, Volks- und Raiffeisen Banken. The giropay online transfer has a number of advantages for merchants. Firstly giropay provides the vendor with a guarantee for payments of up to 10,000 euros; secondly the transfer is a prepayment which minimises the payment term. Finally the customer is using the familiar and trusted online banking of its own credit institution, just the same as with online banking.

In the first step the customer chooses the giropay payment method at the checkout of the online shop and selects its credit institution. The customer is then connected directly to its Sparkasse/bank and logs on as normal using a PIN. A pre-completed transfer form then appears. The customer need only enter their TAN to confirm the payment.

With online banking, the data disclosed in the online transfer is encrypted with SSL (Secure Sockets Layer) to prevent manipulation.

Further information can be found on the webpage of giropay (http://www.giropay.de).

Process flow chart

giropay process flow

Multiexcerpt include
SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

interface

Calling the giropay interface

To initiate a payment with giropay, please use the following URL:

Notice: Please observe that a connection via iFrame is not possible due to existing regulations and will be technically prevented.

Parameters for online transfers with giropay

Result parameters for URLNotify, URLSuccess and URLFailure in case of giropay

Verification of the online status of giropay banks

With

The following table describes the encrypted payment request parameters:

Parameters for verification of the online status of giropay banks

Please transfer the Merchant-ID both in the unencrypted as well as the encrypted string.

The following table describes the result parameters, which

Key

Format

CND

Description

BICList

ans..

M

The BICList parameter contains all banks which are online at the time of the inquiry as comma-separated values.

Example: BICList=TESTBIC1,TESTBIC2,…

Der Parameter BICList enthält sämtliche Banken, die zum Zeitpunkt der Abfrage online sind, als kommaseparierte Werte.

Beispiel: BICList=TESTBIC1,TESTBIC2,…

Result parameters for requesting the giropay banks

Credit with referenceCredit with reference

Notice: Please observe that credits are possible only via PPRO.

Credits (refunds) are possible via a Server-to-Server connection. The

To carry out a credit with a reference transaction, please use the following URL:

Parameters for credits of giropay payments

Result parameters for credits of giropay payments

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing a giropay payment and which information can be found within the response file about the payment status.

Notice: Please note that Batch processing for giropay is possible only via PPRO connection.

Following table gives an overview of all batch versions that are possible for a specific action an their specialities:

Description of the possible batch versions

The structure for a giropay payment within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
GIROPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

HEAD,<MerchantID>,<Date>,<Version>
GIROPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Description of result parameters within the record for Batch files