Giropay is an interbank system, introduced by the German banks in 2005 as the official payment method for online banking. It is accessible by more than 40 million shoppers and accounts for 16% of all online transactions in Germany.
Caractéristiques #
Available country codes | DE |
---|---|
Traitement des devises | EUR |
Devises de règlement | EUR |
Montant minimum de la transaction | 1.00 EUR |
Montant maximum de la transaction | No limit. Up to 10.000 EUR – payment guaranteed* Over 10.000 EUR – payment not guaranteed |
Remboursements | ✅ |
Remboursements partiels | ✅ |
Remboursement partiel multiple | ✅ |
Répétition de la dette | ❌ |
*giropay contractually guarantees the payment for up to 6 weeks after the initial transaction.
Méthode d'intégration #
Valeurs de l'énumération des méthodes de paiement : giropay
There is integration method for Giropay
- API directe
- Sortie de caisse
Direct API #
Comment s'intégrer #
Pour une intégration API directe, vous pouvez créer un PaymentIntent et obtenir l'url en une seule étape. Voici la démonstration de la création d'une intention de paiement :
Un PaymentIntent est un objet qui représente votre intention d'encaisser le paiement de votre client et qui suit le cycle de vie du processus de paiement. Créez un PaymentIntent sur votre serveur et indiquez le montant à encaisser ainsi qu'une devise prise en charge. Si vous disposez d'une intégration Payment Intents existante, ajoutez giropay à la liste des types de méthodes de paiement.
Please note that for this payment method, you need to specify the country in billing_details.address
as Germany, which country code is DE
.
Demande Créer un PaymentIntent
{
"amount": 2000,
"currency": "EUR",
"confirm": true,
"payment_method_data": {
"type": "giropay",
"billing_details": {
"address": {
"country": "DE"
},
"firstName": "",
"lastName": ""
}
},
"return_url": "https://wooshpay.com"
}
Réponse
{
"id": "pi_1670644604036186112",
"object": "payment_intent",
"created": 1687147687000,
"livemode": false,
"currency": "EUR",
"amount": 2000,
"status": "requires_action",
"client_secret": "pi_1670644604036186112_secret_9UHXdOLAE1WV7A1UCIjH8nMP",
"next_action": {
"type": "redirect_to_url",
"giropay_handle_redirect": {
"url": "https://r3.girogate.de/ti/simgiropay?tx=2090827518&rs=33tiT9GdES3vl4zIQ4ShK4Sw3NsvymQj&cs=0981d204f358af0d05ea4aa49a2b678fbe36aa4f13af2624441385921431f7a6"
}
},
"payment_method_types": [
"giropay"
],
"confirmation_method": "automatic",
"return_url": "https://wooshpay.com",
"payment_method": "pm_1670644603939717120",
"capture_method": "automatic"
}
Sortie de caisse #
Flux de paiement #
- Customer selects Giropay from the list of payment methods available and clicks on the Pay botton
- Customers will be redirected to Giropay’s page
- Customers select their bank and approve payment via online banking
Create a seesion #
Demande Créer une session
{
"cancel_url": "www.wooshpay.com",
"mode": "payment",
"success_url": "https://wooshpay.com/",
"payment_method_types": [
"giropay"
],
"line_items": [
{
"price_data": {
"currency": "EUR",
"product": null,
"unit_amount": 2000,
"product_data": {
"name": "apple"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantity": 1
}
]
}
Réponse
{
"id": "cs_1680883889586831360",
"object": "checkout.session",
"created": 1689588923000,
"livemode": false,
"currency": "EUR",
"customer": "",
"mode": "payment",
"status": "open",
"url": "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
"cancel_url": "www.wooshpay.com",
"line_items": {
"object": "list",
"data": [
{
"id": "li_1680883889620385792",
"object": "item",
"currency": "EUR",
"description": "apple",
"price": {
"id": "price_1680883889632968704",
"object": "price",
"created": 1689588923000,
"livemode": false,
"active": false,
"currency": "EUR",
"product": {
"id": "prod_1680883889641357312",
"object": "product",
"created": 1689588923000,
"livemode": false,
"active": false,
"name": "apple",
"updated": 1689588923000
},
"type": "one_time",
"unit_amount": 2000,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"quantity": 1,
"amount_subtotal": 2000,
"amount_total": 2000
}
]
},
"payment_intent": "pi_1680883889804935168",
"payment_method_types": [
"giropay"
],
"payment_status": "unpaid",
"success_url": "https://wooshpay.com/",
"amount_subtotal": 2000,
"amount_total": 2000,
"billing_address_collection": "auto",
"expires_at": 1689675323250,
"payment_link": "",
"client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}
Prochaine étape #
Vous pouvez ajouter d'autres fonctionnalités à votre intégration en fonction de vos besoins.
Créer un Webhook #
Écoutez les événements sur votre compte WooshPay afin que votre intégration puisse déclencher automatiquement des réactions. Créez un webhook qui se concentre principalement sur enabled_events et url.
Créer un remboursement #
Créez un remboursement pour restituer des fonds à votre client. Vous pouvez également effectuer des remboursements partiels, mais ils ne sont pas pris en charge par toutes les méthodes de paiement. Un remboursement partiel consiste à ne rembourser qu'une partie du montant de la transaction initiale.