Akceptuj płatności za pomocą iDEAL, najpopularniejszej metody bankowości internetowej w Holandii, z szerokim wsparciem ze strony głównych holenderskich banków.

Kiedy klienci korzystają z iDEAL, wybierają bank wydający i dokonują płatności na platformie banku. Jest to wysoce bezpieczne, z natychmiastowym powiadomieniem o płatności.

Jak korzystać z iDEAL

Ścieżka przebiega w następujący sposób:

1. Na stronie internetowej sprzedawcy klient wybiera iDEAL jako metodę płatności
2. Zostają przekierowani na stronę, na której znajduje się lista, z której mogą wybrać preferowany bank.
3. Klient wybiera bank z listy i zostaje przekierowany do swojego banku internetowego.
4. Klient potwierdza płatność i zostaje przekierowany z powrotem na stronę sprzedawcy.
5. Sprzedawca otrzymuje potwierdzenie płatności;
6. Sprzedawca może wysłać zamówienie/dostarczyć towary klientowi.

Jak to działa

Oto przegląd najważniejszych kroków wymaganych do integracji metody płatności iDEAL.

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

Pamiętaj, aby zainicjować żądanie zamówienia z iDEAL („IDEL”) jako wybraną metodą płatności (transaction.paymentMethod) i skonfigurować 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 transakcji uzyskany w poprzednim kroku.

Punkty końcowe (Endpoints):

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

Parametry nagłówka:

Nagłówek żądania:

Jak uzyskać link do płatności:

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

Po pomyślnym zakończeniu operacji otrzymywany jest „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: Sprawdź status płatności

Możesz wykonać operację „Uzyskaj 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

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: