Giropay est un système interbancaire, introduit par les Les banques allemandes l'ont adopté en 2005 comme mode de paiement officiel pour les services bancaires en ligne. Il est accessible à plus de 40 millions d'acheteurs et représente 16% de toutes les transactions en ligne en Allemagne.

Caractéristiques #

*giropay garantit contractuellement le paiement jusqu'à 6 semaines après la transaction initiale.

Méthode d'intégration #

Valeurs de l'énumération des méthodes de paiement : giropay

Il existe une méthode d'intégration pour Giropay

1. API directe
2. 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 :

Créer un PaymentIntent

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.

Veuillez noter que pour ce mode de paiement, vous devez spécifier le pays en billing_details.address comme l'Allemagne, quel est l'indicatif de pays DE.

Demande Créer un PaymentIntent

{
    "montant" : 2000,
    "devise" : "EUR",
    "confirm" : true,
    "payment_method_data" : {
        "type" : "giropay",
        "billing_details" : {
            "address" : {
                "country" : "DE"
            },
            "prénom" : "",
            "lastName" : ""
        }
    },
    "return_url" : "https://wooshpay.com"
}

Réponse

{
    "id" : "pi_1670644604036186112",
    "object" : "payment_intent",
    "created" : 1687147687000,
    "livemode" : false,
    "currency" : "EUR",
    "montant" : 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" : "automatique",
    "return_url" : "https://wooshpay.com",
    "payment_method" : "pm_1670644603939717120",
    "capture_method" : "automatic"
}

Sortie de caisse #

Flux de paiement #

1. Le client sélectionne Giropay dans la liste des méthodes de paiement disponibles et clique sur le bouton Payer.

2. Les clients seront redirigés vers la page de Giropay.

3. Les clients choisissent leur banque et approuvent le paiement via la banque en ligne.

Créer une session #

Demande Créer une session

{
    "cancel_url" : "www.wooshpay.com",
    "mode" : "paiement",
    "success_url" : "https://wooshpay.com/",
    "payment_method_types" : [
        "giropay"
    ],
    "line_items" : [
        {
            "price_data" : {
                "currency" : "EUR",
                "produit" : null,
                "unit_amount" : 2000,
                "product_data" : {
                    "name" : "pomme"
                },
                "billing_scheme" : "testscheme",
                "lookup_key" : "test_lookup_key"
            },
            "quantity" : 1
        }
    ]
}

Réponse

{
    "id" : "cs_1680883889586831360",
    "object" : "checkout.session",
    "created" : 1689588923000,
    "livemode" : false,
    "currency" : "EUR",
    "client" : "",
    "mode" : "paiement",
    "status" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
    "cancel_url" : "www.wooshpay.com",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1680883889620385792",
                "objet" : "item",
                "currency" : "EUR",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1680883889632968704",
                    "objet" : "prix",
                    "created" : 1689588923000,
                    "livemode" : false,
                    "active" : false,
                    "currency" : "EUR",
                    "produit" : {
                        "id" : "prod_1680883889641357312",
                        "objet" : "produit",
                        "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" : "non payé",
    "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.