Przelewy24

Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
Przelewy24
Specyfikacja techniczna instalacji
Data: 2013-12-09 Wersja: 3.0a
Dokument zawiera specyfikację techniczną instalacji systemu płatności Przelewy24.
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
Strona 1 z 6
Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
1 Wstęp
2 Konfiguracja w panelu Przelewy24
Ograniczenie dostępu do panelu IP:
Stały adres URL do przesyłania statusu transakcji:
Opłata: Akceptant / Klient
Uruchomione e-pobranie: tak/nie
URL do webservices Akceptanta: (e-Pobranie, potwierdzenia, itp.)
3 Żądanie transakcji
Adres URL: https://secure.przelewy24/trnDirect
Parametry POST transakcji:
Nazwa pola
Typ
Wymagane
Opis
p24_merchant_id
INT
T
ID Sprzedawcy
p24_pos_id
INT
T
ID Sprzedawcy
p24_session_id
STRING(100)
T
p24_amount
INT
T
p24_currency
STRING(3)
T
p24_client_fee *
INT
N
p24_description
STRING(1024)
T
p24_email
STRING(50)
T
p24_client
STRING(40)
N
p24_address
STRING(60)
N
p24_zip
STRING(10)
N
p24_city
STRING(30)
N
p24_country
STRING(30)
T
Kody krajów zgodnie z
załącznikiem nr 2
p24_phone
STRING(12)
N
Telefon
klienta
formacie:
481321132123
p24_language
STRING(2)
N
pl / en / de / es / it
p24_method
INT
N
Lista metod płatności
widoczna w panelu lub
dostępna przez API
p24_url_return
STRING(250)
T
Adres
powrotny
po
zakończeniu transakcji
p24_url_cancel
STRING(250)
T
Adres
powrotny
przypadku
PLN, EUR, GBP, CZK
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
w
w
Strona 2 z 6
Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
rezygnacji/wystąpienia
błędu
p24_url_status *
STRING(250)
N
Adres do przekazania
statusu transakcji
p24_time_limit *
INT
N
Limit czasu na wykonanie
transakcji, 0 - brak limitu(7
dni).Maks. 99
p24_wait_for_result *
INT
N
0 - nie
1 - tak
p24_channel *
INT
N
1 - karty,
2 - przelewy,
4 - przelew tradycyjny,
8 – N/A
16 - tylko on-line
wszystkie 24/7,
32 - użyj przedpłatę
/
p24_shipping
INT
N
p24_transfer_label *
STRING(20)
N
Opis pojawiający się w
tytule przelewu1
p24_api_version
STRING(5)
T
3.0a
Lista zakupów, gdzie X jest liczbą 1-100 (opcjonalne2)
p24_name_X
STRING(127)
T
Nazwa towaru
p24_description_X
STRING(127)
N
Dodatkowy opis towaru
p24_quantity_X
INT
T
Ilość sztuk towaru
p24_price_X
INT
T
Cena
towaru
p24_number_X
INT
N
ID towaru w
Akceptanta
p24_sign
STRING(100)
T
Sum kontrolna
p24_encoding
STRING(10)
N
System
kodowania
przesyłanych znaków
jednostkowa
systemie
* - dostępne w wersji 3.1
1
2
Dodatkowy opis nie pojawia się we wszystkich metodach płatności
Wymagane dla PayPal Protected Payment, systemów ratalnych
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
Strona 3 z 6
Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
4 Wynik transakcji
Adres URL: adres powrotny z transakcji
Parametry POST:
p24_merchant_id
INT
p24_pos_id
INT
p24_session_id
STRING(100)
p24_amount
INT
p24_currency
STRING(3)
p24_order_id
INT
Numer transakcji
przez Przelewy24
p24_method
INT
Metoda
płatności
przez klienta
p24_sign
STRING
Suma kontrolna
nadany
użyta
Weryfikacja otrzymanego wyniku transakcji:
Adres URL: https://secure.przelewy24.pl/trnVerify
Parametry POST:
p24_merchant_id
INT
p24_pos_id
INT
p24_session_id
STRING(100)
p24_amount
INT
p24_currency
STRING(3)
p24_order_id
INT
p24_sign
INT
Numer transakcji
przez Przelewy24
nadany
Wynik
Error
Result
Kody błędów
załączniku nr 1
Bool
zawarte
w
True - transakcja poprawna
False - transakcja błędna
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
Strona 4 z 6
Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
5 Testowanie połączenia
Adres URL: https://secure.przelewy24/testConnection
Parametry POST:
P24_merchant_id
INT
P24_pos_id
INT
P24_sign
sha1(p24_merchant_id+p24_pos_id)
Suma kontrolna
Wynik
Result
Bool
True/False
6 Usługi WebServices
Adres serwera WebServices Przelewy24:
Encoded: https://secure.przelewy24.pl/wsEncoded.wsdl
Literal: https://secure.przelewy24.pl/wsLiteral.wsdl
Dokumentacja do pobrania ze strony www.przelewy24.pl
7 Informacje dodatkowe
7.1 Adresy IP serwerów Przelewy24
Zakres adresów IP serwerów:
217.168.139.48 – 217.168.139.55
217.168.128.198 – 217.168.128.202
91.216.191.181 – 91.216.191.185
7.2 Cykl powiadamiania o wpłacie
System przewiduje 5-krotne powiadomienie systemu Merchanta o wpłacie Klienta.
Powiadomienia wysyłane są w podanych poniżej odstępach czasu z tolerancją +/- 5 minut.
Powiadomienia wysyłane są w następujących odstępach: 15, 30, 60, 150 i 450 minut, po
upłynięciu 15 minutowego czasu na dokonanie wpłaty przez Klienta.
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
Strona 5 z 6
Przelewy24 – Specyfikacja techniczna instalacji
Opracował: Dział IT
(Telefon 61 642 93 43)
Załącznik nr 1 – Historia zmian
Data
Autor
Uwagi
2013-10-10
Opracowanie dokumentu
2013-12-09
Update
DialCom24 Sp. z o.o. Ul. Kanclerska 15, 60-327 Poznań, Polska
tel. +48 48 61 642 93 44 fax + 48 61 642 90 31 [email protected]
NIP 781-173-38-52, REGON 634509164, Sąd Rejonowy Poznań, VIII Wydz. Gospodarczy Krajowego Rejestru Sądowego
Nr KRS 0000306513, wysokość kapitału zakładowego: 1 697 000 zł
Strona 6 z 6