Zacznij akceptować płatności za pośrednictwem SOFORT, SOFORT, szeroko stosowanej metody w Europie.

Umożliwia ona klientom dokonywanie płatności bezpośrednio z ich kont bankowych przy użyciu danych bankowości internetowej. Po dokonaniu zakupu otrzymują oni potwierdzenie transakcji, co umożliwia szybkie przetworzenie zamówienia.

Jak używać SOFORT

Oto jak przebiega ten proces:

1. Na stronie internetowej sprzedawcy klient wybiera SOFORT jako wybraną metodę płatności.
2. Klient jest przekierowywany na stronę, na której może wyszukać i wybrać preferowany bank z listy.
3. Następnie są przekierowywani do środowiska online wybranego banku.
4. Klient loguje się na swoje konto bankowe przy użyciu swoich danych logowania.
5. Następnie klient sprawdza szczegóły płatności przed potwierdzeniem transakcji poprzez wprowadzenie kodu autoryzacji transakcji.
6. Na koniec klient jest płynnie przekierowywany z powrotem na stronę sprzedawcy.
7. Sprzedawca otrzymuje powiadomienie o płatności.

Jak to działa

Poniżej znajduje się niezbędny przewodnik przedstawiający kluczowe kroki niezbędne do integracji metody płatności SOFORT.

Krok 1: Utwórz zamówienie

Krok 2: Uzyskaj link do płatności

Krok 3: Uzyskanie statusu płatności

Krok 1: Utwórz zamówienie

Upewnij się, że zainicjowałeś żądanie zamówienia z SOFORT („SFRT”) jako wybraną metodą płatności (transaction.paymentMethod) i ustaw preferencje językowe klienta w customerInfo.customerLanguage.

Krok 2: Uzyskaj link do płatności

Postępuj zgodnie z poniższymi instrukcjami, aby uzyskać link do płatności, aby 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 transactionSignature uzyskany w poprzednim kroku.

Punkty końcowe (Endpoints):

Upewnij się, że zawierasz te niezbędne elementy, jak określono:

Parametry nagłówka:

Parametry żądania:

Oto przykład, jak uzyskać link do płatności:

{
 "userAcceptanceIndicator": true,
 "gatewayId": "directpay",
 "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": "NL"
 }
 },
 "merchant": {
 "merchantURL": https://egadget2.azurewebsites.net/#/returns?id={{transactionId}}
 }
}

Po pomyślnym zakończeniu operacji pojawi się komunikat „pending” paymentStatus .

Użytkownik jest następnie przekierowywany do środowiska potwierdzenia płatności, a następnie płynnie powraca do adresu URL sprzedawcy.

Krok 3: Uzyskanie statusu płatności

Możesz wykonać operację „Get Status”, aby sprawdzić status w dowolnym momencie.

Nagłówek HTTP Authorization jest ustawiony na token Bearer, który został użyty w początkowym Checkoucie.

GET {transactionID}/status

Żądanie URL:

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: