Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Giropay è un sistema di pagamento per l'e-commerce utilizzato in Germania che consente al pagante di utilizzare trasferimenti online diretti dal proprio conto corrente bancario. Il pagante viene reindirizzato al sito Web del servizio bancario online dove avvia un trasferimento bancario immediato.
Giropay è una delle modalità di pagamento tramite browser supportate nel Mastercard Gateway. In questa pagina vengono descritti i dettagli specifici dell'integrazione di Giropay. Si consiglia di leggere le Linee guida per l'integrazione per il pagamento tramite browser prima di creare un'integrazione Giropay.
I pagamenti tramite browser Giropay sono supportati solo per le transazioni nella valuta EUR.
Per offrire Giropay come modalità di pagamento mediante il Mastercard Gateway:
Con le integrazioni Hosted Checkout versione 50 e successive, Giropay è automaticamente disponibile per i paganti quando l'esercente è abilitato e configurato per Giropay dal proprio provider di servizi di pagamento.
Per ulteriori dettagli, vedere Pagamenti tramite browser mediante integrazione Hosted Checkout.
L'integrazione di Direct Payment consente di offrire la modalità di pagamento Giropay sulla propria pagina di checkout.
Per l'elaborazione dei pagamenti Giropay, in una richiesta di pagamento tramite browser, oltre ai campi standard obbligatori, è necessario fornire i seguenti campi nella richiesta Initiate Browser Payment
.
sourceOfFunds.type = GIROPAY
browserPayment.operation = PAY
(l'operazione Authorize non è supportata da Giropay).sourceOfFunds.provided.giropay.bankIdentifier
: (opzionale) fornire il codice bancario (Bankleitzahl) del conto corrente bancario tedesco del pagante.sourceOfFunds.provided.giropay.bic
: il BIC (codice bancario internazionale) del conto corrente bancario del pagante. Per migliorare l'esperienza del pagante si consiglia di fornire questo campo. In questo modo, al pagante non verrà visualizzato il modulo di selezione della banca, ma verrà invece reindirizzato automaticamente alla propria banca.È possibile impostare la lingua che si desidera sia utilizzata da Giropay per le pagine mostrate al pagante fornendo il campo browserPayment.preferredLanguage
nella richiesta Initiate Browser Payment. Tuttavia, la lingua verrà utilizzata solo se supportata da Giropay.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"https://<return_url>" }, "order":{ "amount":"10.00", "currency":"EUR" }, "sourceOfFunds":{ "type":"GIROPAY" } }
Nella tabella che segue sono illustrati i possibili scenari per i codici di risposta della transazione restituiti dopo l'avvio di un pagamento Giropay.
Risposta Initiate Browser Payment |
Cosa significa... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Reindirizzare il pagante utilizzando l'URL fornito nella risposta. |
Risposta di Retrieve Transaction/Retrieve Order |
Cosa significa... |
response.gatewayCode=APPROVED result=SUCCESS sourceOfFunds.provided.giropay.bankIdentifier sourceOfFunds.provided.giropay.bic
|
Il pagamento è avvenuto correttamente. |
response.gatewayCode= PENDING result=PENDING |
Il Mastercard Gateway sta aspettando una notifica dall'acquirer sul risultato del pagamento. Riprovare RETRIEVE_TRANSACTION più tardi o controllare le notifiche del Mastercard Gateway. |
response.gatewayCode= CANCELLED result=FAILURE |
Il pagante ha annullato l'interazione per il pagamento. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Il pagamento è stato rifiutato. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. In presenza di un ACQUIRER_SYSTEM_ERROR è possibile richiedere all'acquirer il motivo dell'esito negativo del pagamento, oppure riprovare RETRIEVE_TRANSACTION . |
response.gatewayCode=TIMED_OUT result=FAILURE |
Considerare questo pagamento come rifiutato. Il Mastercard Gateway tenterà di garantire che la transazione non abbia esito positivo o revocherà la transazione. |
È possibile rimborsare completamente o parzialmente i pagamenti Giropay. È necessario essere configurati per i rimborsi sul Mastercard Gateway e sul proprio conto esercente presso il provider di servizi di pagamento tramite browser.
Il Mastercard Gateway fornisce un simulatore di pagamento tramite browser che consente di verificare la propria integrazione Giropay.