Giropay
paymentmethod=GPA
| Payment Process | Integration | ||
|---|---|---|---|
| Authorization | ✔️ | Payment Page | ✔️ |
| Deferred Settlement | ❌ | Split Mode | ❌ |
| Refund | ❌ | Mobile SDK | ❌ |
| Cancel | ❌ | ||
| Alias | ❌ |
Description
Bank transfers are one of the most popular forms of payment in Germany. To make transfers possible without media disruption in e-commerce, too, integration of giropay is advisable. This method is based on online transfers using PIN and TAN and does not require additional registration by the buyer.
The buyer completes the transfer in the secure online banking portal of his bank or savings bank. Immediately after the successful transfer, the payment recipient (online shop) receives an irrevocable payment guarantee from the buyer’s bank and thus has 100% protection against payment defaults. More than 35 million customers in Germany can use giropay.
Payment Method provider website 🔗
Request and response parameter reference
For a more detailed description of the request and response parameters for Giropay
please check the API Reference
Test
Login Information
bank account/ login: sepatest1
PIN: any 5-digit number
TAN: any 6-digit number
Web payment flow
Shopping cart type
Additional parameters are required in your requests to successfully process Giropay transactions and ensure consumers benefit from additional features like buyer protection and a money-back guarantee. Two mandatory parameters to include are gpaShoppingCartType and uppShippingDetails. The table below specifies additional mandatory parameters, depending on the shopping cart type you submit.
| Shopping cart type | Description | Additional fields |
|---|---|---|
PHYSICAL | All goods in the cart are of a physical nature. | uppShippingDetails=yes, uppShippingFirstName, uppShippingLastName, uppShippingZipCode, uppShippingCity, uppShippingCountry |
DIGITAL | All goods in the cart are of a digital nature. | uppShippingDetails=yes, uppShippingFirstName, uppShippingLastName, uppShippingEmail |
MIXED | The cart contains both physical and digital goods. | uppShippingDetails=yes, uppShippingFirstName, uppShippingLastName, uppShippingZipCode, uppShippingCity, uppShippingCountry |
ANONYMOUS_DONATION | This is an anonymous donation and not a commercial transaction. | uppShippingDetails=yes |
AUTHORITIES_PAYMENT | This is a payment for local authorities. | uppShippingDetails=yes |
Server to Server API calls
After a transactionId or alias was received by completing the payment flow on the web, the following server to server API calls can be used to do other actions.
Authorization
Is only possible through the web interface.
Settlement
Not possible as Griopay is a direct debit method. Default reqtype=CAA
Cancel
Can not be canceled since it is a direct debit method
Credit
Credit option not available
Status
Request
curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_status.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<statusService version="5">
<body merchantId="1000011011">
<transaction>
<request>
<uppTransactionId>180830161324498844</uppTransactionId>
<reqtype>STX</reqtype>
</request>
</transaction>
</body>
</statusService>
EOF
Response
<?xml version='1.0' encoding='UTF-8'?>
<statusService version='5'>
<body merchantId='1000011011' status='accepted'>
<transaction trxStatus='response'>
<request>
<uppTransactionId>180830161324498844</uppTransactionId>
<reqtype>STX</reqtype>
</request>
<response itemNr='1'>
<responseCode>11</responseCode>
<responseMessage>Trx authentified</responseMessage>
<refno>396617</refno>
<refno2>Testing purchase</refno2>
<amount>100</amount>
<currency>EUR</currency>
<authorizationCode>409188939</authorizationCode>
<pmethod>GPA</pmethod>
<uppTransactionId>180830161324498844</uppTransactionId>
<maskedCC></maskedCC>
<aliasCC></aliasCC>
<expm></expm>
<expy></expy>
<trxDate>20180830</trxDate>
<trxTime>161324</trxTime>
<trtype>05</trtype>
</response>
</transaction>
</body>
</statusService>
Updated 6 months ago