Deprecated
Accept a giropay payment Deprecated
Learn how to accept giropay, a common payment method in Germany.
Deprecated
Our financial partners are deprecating Giropay. No new business onboarding or transactions will be possible after June 30, 2024. Read our support page for more details.
Web
Mobile
giropay is a single use payment method where customers are required to authenticate their payment. Customers pay with giropay by redirecting from your website, authorizing the payment, then returning to your website where you get immediate notification on whether the payment succeeded or failed. Because giropay is a single use payment method, it isn’t compatible with SetupIntents.
Note
Your use of giropay must be in accordance with the giropay Terms of Service.
Depending on how you settle payments, there might be additional notification requirements to be aware of.
Determine compatibility
A Checkout Session must satisfy all of the following conditions to support giropay payments:
- Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
- You can only use one-time line items (recurring subscription plans aren’t supported).
Accept a payment
Note
Build an integration to accept a payment with Checkout before using this guide.
Use this guide to learn how to enable giropay—it shows the differences between accepting a card payment and using giropay.
Enable giropay as a payment method
When creating a new Checkout Session, you need to:
- Enable Giropay in your Dashboard. Stripe automatically displays Giropay to eligible customers using dynamic payment methods . If you currently specify payment _ method _ types , see the migration guide .
- Make sure all your line _ items use the eur currency
Select a language
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
client.v1.checkout.sessions.create({
mode: 'payment',
line_items: [{
price_data: {
currency: 'usd',
# To accept `giropay`, all line items must have currency: eur
currency: 'eur',
product_data: {
name: 'T-shirt'
},
unit_amount: 2000
},
quantity: 1
}],
success_url: 'https://example.com/success'
})
Fulfill your orders
After accepting a payment, learn how to fulfill orders.
Test your integration
When testing your Checkout integration, select giropay as the payment method and click the Pay button.
Handle refunds and disputes
The refund period for giropay is up to 180 days after the original payment.
There is no dispute process—customers authenticate with their bank.