Giropay è un sistema interbancario, introdotto da il Nel 2005 le banche tedesche sono diventate il metodo di pagamento ufficiale per l'online banking. È accessibile a più di 40 milioni di acquirenti e rappresenta il 16% di tutte le transazioni online in Germania.

Caratteristiche #

*giropay garantisce contrattualmente il pagamento fino a 6 settimane dopo la transazione iniziale.

Metodo di integrazione #

Valori dell'enumerazione del metodo di pagamento: giropay

Esiste un metodo di integrazione per Giropay

1. API diretta
2. Cassa

Diretto API #

Come integrare #

Per l'integrazione diretta con l'API, è possibile creare un PaymentIntent e ottenere l'url in un solo passaggio. Di seguito è riportata la demo della creazione di un intento di pagamento:

Creare un Intento di pagamento

Un PaymentIntent è un oggetto che rappresenta l'intenzione di riscuotere un pagamento dal cliente e tiene traccia del ciclo di vita del processo di pagamento. Creare un PaymentIntent sul server e specificare l'importo da riscuotere e una valuta supportata. Se si dispone di un'integrazione PaymentIntents esistente, aggiungere giropay all'elenco dei tipi di metodo di pagamento.

Si prega di notare che per questo metodo di pagamento è necessario specificare il paese in dettagli_di_fatturazione.indirizzo come Germania, il cui codice paese è DE.

Richiesta Creare un Intento di pagamento

{
    "importo": 2000,
    "valuta": "EUR",
    "conferma": vero,
    "dati_metodo_di_pagamento": {
        "tipo": "giropay",
        "dettagli_fatturazione": {
            "indirizzo": {
                "paese": "DE"
            },
            "nome": "",
            "cognome": ""
        }
    },
    "return_url": "https://wooshpay.com"
}

Risposta

{
    "id": "pi_1670644604036186112",
    "oggetto": "payment_intent",
    "creato": 1687147687000,
    "livemode": false,
    "currency": "EUR",
    "importo": 2000,
    "stato": "requires_action",
    "client_secret": "pi_1670644604036186112_secret_9UHXdOLAE1WV7A1UCIjH8nMP",
    "next_action": {
        "tipo": "redirect_to_url",
        "giropay_handle_redirect": {
            "url": "https://r3.girogate.de/ti/simgiropay?tx=2090827518&rs=33tiT9GdES3vl4zIQ4ShK4Sw3NsvymQj&cs=0981d204f358af0d05ea4aa49a2b678fbe36aa4f13af2624441385921431f7a6"
        }
    },
    "tipi_di_pagamento": [
        "giropay"
    ],
    "metodo_di_conferma": "automatic",
    "return_url": "https://wooshpay.com",
    "metodo di pagamento": "pm_1670644603939717120",
    "metodo di acquisizione": "automatic"
}

Cassa #

Flusso di pagamento #

1. Il cliente seleziona Giropay dall'elenco dei metodi di pagamento disponibili e clicca sul pulsante Paga.

2. I clienti saranno reindirizzati alla pagina di Giropay

3. I clienti selezionano la propria banca e approvano il pagamento tramite l'online banking

Creare una visione #

Richiesta Creare una sessione

{
    "cancel_url": "www.wooshpay.com",
    "modalità": "payment",
    "success_url": "https://wooshpay.com/",
    "tipi_di_metodo_di_pagamento": [
        "giropay"
    ],
    "voci_di_linea": [
        {
            "price_data": {
                "valuta": "EUR",
                "prodotto": null,
                "importo_unità": 2000,
                "dati_prodotto": {
                    "nome": "apple"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità": 1
        }
    ]
}

Risposta

{
    "id": "cs_1680883889586831360",
    "oggetto": "checkout.session",
    "creato": 1689588923000,
    "livemode": false,
    "currency": "EUR",
    "cliente": "",
    "modalità": "pagamento",
    "stato": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
    "cancel_url": "www.wooshpay.com",
    "voci_di_linea": {
        "oggetto": "elenco",
        "dati": [
            {
                "id": "li_1680883889620385792",
                "oggetto": "item",
                "valuta": "EUR",
                "descrizione": "mela",
                "prezzo": {
                    "id": "price_1680883889632968704",
                    "oggetto": "prezzo",
                    "creato": 1689588923000,
                    "livemode": false,
                    "active": false,
                    "valuta": "EUR",
                    "prodotto": {
                        "id": "prod_1680883889641357312",
                        "oggetto": "prodotto",
                        "creato": 1689588923000,
                        "livemode": false,
                        "active": false,
                        "nome": "apple",
                        "aggiornato": 1689588923000
                    },
                    "tipo": "one_time",
                    "importo_unità": 2000,
                    "schema di fatturazione": "per_unità",
                    "lookup_key": "test_lookup_key"
                },
                "quantità": 1,
                "importo_subtotale": 2000,
                "importo_totale": 2000
            }
        ]
    },
    "Intento di pagamento": "pi_1680883889804935168",
    "tipi_di_pagamento": [
        "giropay"
    ],
    "payment_status": "unpaid",
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 2000,
    "importo_totale": 2000,
    "indirizzo_di_fatturazione": "auto",
    "scadenza": 1689675323250,
    "link_di_pagamento": "",
    "client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}

Passo successivo #

È possibile aggiungere altre funzionalità all'integrazione in base alle esigenze.

Creare un webhook #

Ascoltate gli eventi sul vostro account WooshPay in modo che la vostra integrazione possa attivare automaticamente le reazioni. Creare un webhook che si concentri principalmente su enabled_events e url.

Creare un rimborso #

Creare un rimborso per restituire i fondi al cliente. È possibile eseguire anche rimborsi parziali, ma non tutti i metodi di pagamento li supportano. Un rimborso parziale consiste nel rimborsare solo una parte dell'importo della transazione originale.