Bankowość internetowa jest bardzo popularna w Polsce, a Przelewy24 czynią ją jeszcze wygodniejszą.

Przelewy24, znane jako P24, współpracują z ponad 165 bankami, upraszczając proces płatności. Kupujący wybierają bank wydający i dokonują płatności na platformie banku, bez konieczności ręcznego podawania danych przelewu, co przyspiesza proces.

Sprzedawcy mogą szybko rozpocząć działalność bez konieczności posiadania oddzielnego konta P24.

Jak korzystać z Przelewy24

Proces ten przebiega w następujący sposób:

1. Klient inicjuje proces płatności, wybierając P24 jako preferowaną metodę płatności na stronie płatności sprzedawcy.
2. Następnie klient zostanie przekierowany na stronę płatności P24, gdzie będzie mógł wybrać swój bank.
3. Stamtąd klient jest przekierowywany do portalu bankowości internetowej swojego banku.
4. Aby zatwierdzić transakcję, klient bezpiecznie loguje się na swoje konto bankowości internetowej.
5. Po potwierdzeniu, klient jest szybko przekierowywany na stronę sprzedawcy w celu potwierdzenia płatności.

Jak to działa

Poniżej przedstawiamy najważniejsze kroki wymagane do integracji metody płatności Przelewy24.

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 utworzyć żądanie zamówienia z Przelewy24 (“PY24”) jako wybraną metodę płatności (transaction.paymentMethod) i ustawić preferencje językowe klienta w customerInfo.customerLanguage.

Krok 2: Uzyskaj link do płatności

Przejdź do uzyskania linku do płatności, opisanego poniżej, 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 transactionSignature uzyskany w poprzednim kroku.

Punkty końcowe:

Upewnij się, że posiadasz te niezbędne elementy:

Header parameters:

Request parameters:

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 paymentStatus „oczekujący”.

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

Krok 3: Uzyskaj status płatności

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

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

GET {transactionID}/status

Request URL:

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

Request Headers:

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

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

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