giropay to niemiecka metoda płatności, która upraszcza zakupy online dzięki szybkim, bezpiecznym i gwarantowanym przelewom bankowym.

Jest to metoda płatności oparta na bankowości internetowej, która umożliwia klientom dokonywanie transakcji online, a środki są pobierane bezpośrednio z ich rachunków bankowych. W zależności od banku klienci mogą potwierdzać płatności za pomocą uwierzytelniania drugiego stopnia lub kodu PIN.

Jak korzystać z giropay

Podróż przebiega w następujący sposób:

1. Na stronie sprzedawcy klient wybiera płatność online za pośrednictwem giropay.
2. Klient zostaje przekierowany na stronę, na której może wybrać preferowany bank i zostaje przekierowany na stronę bankowości internetowej banku.
3. Następnie klient bezpiecznie loguje się do wybranego banku, korzystając z danych uwierzytelniających konta.
4. Następnie klientowi prezentowane jest podsumowanie transakcji, umożliwiające mu przejrzenie wszystkich szczegółów transakcji przed autoryzacją płatności.
5. Po autoryzacji potwierdzenie transakcji natychmiast dociera do klienta, a konsument zostaje przekierowany na stronę internetową sprzedawcy.
6. Sprzedawca zostaje powiadomiony o pomyślnej płatności.

Jak to działa

Poniżej znajdziesz szczegółowy przegląd kluczowych kroków niezbędnych do integracji metody płatności giropay.

Krok 1: Utwórz zamówienie

Krok 2: Uzyskaj Link do płatności

Krok 3: Uzyskaj status płatności

Krok 1: Utwórz zamówienie

Upewnij się, że zainicjowałeś żądanie zamówienia z wybraną metodą płatności giropay („GRPY”) (transaction.paymentMethod) i skonfigurowałeś preferencje językowe klienta w CustomerInfo.customerLanguage.

Krok 2: Uzyskaj Link do płatności

Postępuj zgodnie z podanymi instrukcjami, aby uzyskać link do płatności, i przekierować klienta na bezpieczną stronę płatności w celu uwierzytelnienia i autoryzacji płatności.

Należy pamiętać, że poniższe żądanie wymaga nagłówka autoryzacji zawierającego podpis transakcji uzyskany w poprzednim kroku.

Punkty końcowe:

Upewnij się, że uwzględniłeś następujące istotne elementy zgodnie ze specyfikacją:

Parametry nagłówka:

Parametry żądania:

Oto przykładowy sposób uzyskania linku do płatności:

{
 "userAcceptanceIndicator": true,
 "gatewayId": "giropay",
 "info": {
 "deviceInfo": {
 "browserAcceptHeader": "application/json, text/plain, */*",
 "browserJavaEnabled": "false",
 "browserLanguage": "en",
 "browserColorDepth": "24",
 "browserScreenHeight": "1080",
 "browserScreenWidth": "1920",
 "browserTZ": "-60",
 "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
 "geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
 "systemFamily": "Windows",
 "systemVersion": "Windows",
 "deviceID": "498bfd4c3a3645b38667a7037b616c18",
 "applicationName": "Chrome",
 "applicationVersion": "106"
 },
 "customerInfo": [
 {
 "key": "customerName",
 "value": "Test Name"
 },
 {
 "key": "customerEmail",
 "value": email@provider.com
 }
 ],
 "accountInfo": {
 "holderName": "Test Name",
 "customerCountry": "DE"
 }
 },
 "merchant": {
 "merchantURL": https://egadget2.azurewebsites.net/#/returns?id={{transactionId}}
 }
}

Po pomyślnym zakończeniu operacji otrzymany zostanie status płatności „oczekujący”.

Użytkownik zostaje następnie przekierowany do środowiska potwierdzenia płatności, po czym bezproblemowo powróci do adresu URL sprzedawcy.

Krok 3: Uzyskaj status płatności

W dowolnym momencie możesz wykonać operację „Pobierz status”, aby sprawdzić status.

Nagłówek HTTP autoryzacji jest ustawiony na token okaziciela, tak jak był używany podczas początkowej realizacji transakcji.

GET {transactionID}/status

Adres URL żądania:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Nagłówki żądań:

Authorization: ‘Bearer <AuthToken>’
X-IBM-Client-Id: ‘<ClientId>’
Content-Type: application/json

Pomyślna odpowiedź techniczna składa się ze statusu HTTP-200 i returnStatus.statusCode=”000″.

Oto kilka przykładów możliwych kodów wyników: