giropay
Integrate giropay and allow merchants to offer secure online payments via over 1500 banks and saving banks in Germany.
Payment Method Properties
Available country codes | DE |
Processing (Presentation) currencies | EUR |
Settlement currencies | EUR |
Consumer currencies | EUR |
Channel member tag | giropay |
Scheme name in the settlement file | Giropay |
Minimum transaction amount | EUR 1.00 |
Maximum transaction amount | No limit. |
Session timeout | 1 hour |
Refund | Full, partial and multiple partial refunds are all available. |
Refund Validity | 365 days |
Chargeback | No |
Integration Type | Asynchronous |
Sandbox | PPRO-hosted |
*giropay contractually guarantees the payment for up to 6 weeks after the initial transaction.
Transaction Flow
- On the merchant's payment page, the consumer chooses to pay online via giropay.
- They are redirected to the scheme-hosted bank selection page.
- The consumer selects the bank and is redirected to the bank's online banking website to authorise the payment.
- They log into the online banking and confirm the payment.
- The consumer is redirected to the merchant's website by clicking 'go back to the shop'.
giropay Integration
Specific input parameters for the TRANSACTION call
giropay requires no specific input parameters.
For standard input parameters, see Input parameters for the TRANSACTION call.
This payment method supports the dynamic descriptor field (see The dynamic descriptor).
Specific output parameters for the TRANSACTION call
This payment method will emit the SPECOUT.PAYMENTPURPOSE output parameter.
See Well-known SPECOUT parameters for details on well-known specific output parameters.
For standard output parameters, see Output parameters for the TRANSACTION call.
TRANSACTION call input
tag=giropay
&txtype=TRANSACTION
&countrycode=DE
¤cy=EUR
&amount=1055
&merchanttxid=zZx5WZ3dkbMp
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOECONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
¬ificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&specin.dynamicdescriptor=DynDescriptor
&accountholdername=John%20Doe
&returnmode=urlencodeext
TRANSACTION call output
REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=814782598
&ERRMSG=
&CHANNEL=testchannel
&TAG=giropay
&PAYMENTGUARANTEE=NONE
&REDIRECTSECRET=IBkT3gYHRZIZ61YonJOx8JRb5AAee7f9
&SPECOUT_PAYMENTPURPOSE=34Y6BO6 John Doe
&SPECOUT_SRCCOUNTRY=DE
Branding Guidelines
For branding information, see the giropay branding guidelines.
Additional Information
- Transactions may change from any state at any time. This change occurs especially from a FAILED to a SUCCEEDED state. SUCCEEDED is considered a stable state (see also Important note about transaction states).
- To check if your bank is supported, see this page.
Updated 7 months ago