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.
| Opcja płatności | Kategoria | Kraj | Waluta | Cechy | Integracje |
|---|---|---|---|---|---|
| iDEAL | Bankowość internetowa | Holandia | EUR | Częściowy zwrot kosztów Zwrot kosztów Anulowanie | API Formularz płatności Wtyczka Prestashop Wyczka WooCommerce Wtyczka Magento |
Jak korzystać z iDEAL
Ścieżka przebiega w następujący sposób:
- Na stronie internetowej sprzedawcy klient wybiera iDEAL jako metodę płatności
- Zostają przekierowani na stronę, na której znajduje się lista, z której mogą wybrać preferowany bank.
- Klient wybiera bank z listy i zostaje przekierowany do swojego banku internetowego.
- Klient potwierdza płatność i zostaje przekierowany z powrotem na stronę sprzedawcy.
- Sprzedawca otrzymuje potwierdzenie płatności;
- 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: Uzyskaj status 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):
| Środowisko | URL | Metoda działania i punkt końcowy (Endpoint) | Opis działania |
|---|---|---|---|
| PROD | api.sibsgateway.com | POST {version-id}/payments/{id}/pbl/payment-link | Przeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności. |
| TEST | stargate-cer.qly.site[1|2].sibs.pt | POST {version-id}/payments/{id}/pbl/payment-link | Przeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności. |
Upewnij się, że zawierasz te niezbędne elementy, jak określono:
| Lokalizacja | Element danych | Typ | Stan | Opis |
|---|---|---|---|---|
| Ścieżka | id | String | Obowiązkowe | Służy do identyfikacji transakcji |
Parametry nagłówka:
| Lokalizacja | Element danych | Typ | Stan | Opis |
|---|---|---|---|---|
| Request Header | Content-Type | String | Obowiązkowe | application/json |
| Request Header | Autoryzacja | String | Obowiązkowe | Podsumowanie autoryzacji |
Nagłówek żądania:
| Lokalizacja | Element danych | Typ | Stan | Opis |
|---|---|---|---|---|
| Treść żądania | userAcceptanceIndicator | Wartość logiczna | Obowiązkowe | Wskazuje, czy użytkownik zaakceptował Regulamin w celu kontynuowania płatności. |
| Treść żądania | gatewayId | String | Obowiązkowe | Identyfikator kanału płatności dla kanału, którego klient zamierza użyć do dokonania płatności. Warość: 'ideal’ – iDEAL; |
| Treść żądania | info | Info | Obowiązkowe | Obiekt definiujący dodatkowe informacje o transakcji. |
| Rządanie Body.info | deviceInfo | DeviceInfo | Opcjonalne | Obiekt definiujący informacje o urządzeniu klienta. |
| Request Body.info.deviceInfo | browserAcceptHeader | ciąg | Opcjonalne | Browser Accept Header |
| Request Body.info.deviceInfo | browserJavaEnabled | ciąg | Opcjonalne | Browser Java Enabled |
| Request Body.info.deviceInfo | browserLanguage | ciąg | Opcjonalne | browser Language |
| Request Body.info.deviceInfo | browserColorDepth | ciąg | Opcjonalne | browser Color Depth |
| Request Body.info.deviceInfo | browserScreenHeight | ciąg | Opcjonalne | browser Screen Height |
| Request Body.info.deviceInfo | browserScreenWidth | ciąg | Opcjonalne | browser Screen Width |
| Request Body.info.deviceInfo | browserTZ | ciąg | Opcjonalne | Browser Time Zone |
| Request Body.info.deviceInfo | browserUserAgent | ciąg | Opcjonalne | Browser User Agent |
| Request Body.info.deviceInfo | systemFamily | ciąg | Opcjonalne | System Family |
| Request Body.info.deviceInfo | systemVersion | ciąg | Opcjonalne | System Version |
| Request Body.info.deviceInfo | systemArchitecture | ciąg | Opcjonalne | System Architecture |
| Request Body.info.deviceInfo | deviceManufacturer | ciąg | Opcjonalne | Device Manufacturer |
| Request Body.info.deviceInfo | deviceModel | ciąg | Opcjonalne | Device Model |
| Request Body.info.deviceInfo | deviceID | ciąg | Opcjonalne | Device Unique Identification |
| Request Body.info.deviceInfo | applicationName | ciąg | Opcjonalne | Application Name |
| Request Body.info.deviceInfo | applicationVersion | ciąg | Opcjonalne | Application Version |
| Request Body.info.deviceInfo | geoLocalization | ciąg | Opcjonalne | Geolocation |
| Request Body.info.deviceInfo | ipAddress | ciąg | Opcjonalne | Adres IP |
| Treść żądania | customerInfo | CustomerInfo | Opcjonalne | Key Value tuple array. |
| Request Body.customerInfo | klucz | ciąg | Obowiązkowe | Używane do podania „customerName”, „customerEmail”. |
| Request Body.customerInfo | wartość | ciąg | Obowiązkowe | Używane do podania „customerName”, „customerEmail”. |
| Treść żądania | kupiec | Handlowiec | Opcjonalne | Merchant Data |
| Żądanie Body.merchant | merchantURL | ciąg | Obowiązkowe | Adres URL sklepu sprzedawcy do przekierowania. |
| Rządanie Body.info | accountInfo | AccountInfo | Opcjonalne | Dane związane z kontem Ma zastosowanie, gdy gatewayId jest „idealny |
| Request Body.info.accountInfo | holderName | Max100Text | Opcjonalne | Nazwa posiadacza konta. Format UTF-8 . |
| Request Body.info.accountInfo | customerCountry | Kod kraju Klienta | Opcjonalne | Kod kraju Klienta. Alpha2 |
Jak uzyskać link do płatności:
{
"userAcceptanceIndicator": true,
"gatewayId": "ideal",
"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: Uzyskaj 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}/statusAdres URL żądania:
https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/statusNagłó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:
| Kod wyniku | statusMsg | Opis | Akcja |
|---|---|---|---|
| HTTP-200 | Sukces | Odpowiedź powodzenia | Nie dotyczy |
| HTTP-400 | Zła prośba | Ładunek JSON nie jest zgodny z definicją API lub brakuje niektórych obowiązkowych nagłówków HTTP. | Sprawdź w API Market poprawną składnię. |
| HTTP-401 | Nieautoryzowany | W przypadku Autoryzacji token okaziciela jest nieprawidłowy/wygasł lub nie jest powiązany z używanym terminalem. | Sprawdź w SIBS Backoffice w sekcji Poświadczenia, czy token jest ważny i w razie potrzeby utwórz nowy. |
| HTTP-403 | Zabroniony | Identyfikator klienta ustawiony w nagłówku HTTP X-IBM-Client-Id jest nieprawidłowy lub nie posiada prawidłowej subskrypcji interfejsu API. | Sprawdź w SIBS Backoffice w SPG APP 2.0, czy ClientID jest poprawny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu zresetowania ClientID. |
| HTTP-405 | Niedozwolona metoda | Zastosowana metoda HTTP nie jest zgodna z żadną dostępną definicją API. | Sprawdź w API Market poprawną metodę HTTP. |
| HTTP-429 | Zbyt dużo zapytań | Przekroczono limit szybkości wywołań API. | Informacje na temat limitów stawek mających zastosowanie do API można znaleźć w API Market. |
| HTTP-500 | Wewnętrzny błąd serwera | Wywołanie API nie powiodło się… i najprawdopodobniej jest to po naszej stronie. | Powinieneś ponowić operację, a jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu uzyskania pomocy. |
| HTTP-503 | serwis niedostępny | Wywołanie API nie jest obecnie dostępne. Zwykle jesteśmy zawsze aktywni, ale podczas planowej konserwacji mogą wystąpić krótkie problemy z dostępnością. | Powinieneś poczekać i spróbować ponownie później. |