Przelewy24

Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
Przelewy24
Specyfikacja techniczna instalacji
Data: 2013-12-11 Wersja: 3.0b
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 Żą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
PLN, EUR, GBP, CZK
p24_city
STRING(30)
N
p24_country
STRING(2)
T
Kody krajów zgodnie z
załącznikiem nr 2
p24_phone
STRING(12)
N
Telefon
klienta
w
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
(w tym status transakcji)
p24_url_cancel
STRING(250)
T
Adres
powrotny
w
przypadku 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,
maks. 99(w minutach)
p24_wait_for_result *
INT
N
0 - nie
1 - tak
p24_channel *
INT
N
1 - karty,
2 - przelewy,
4 - przelew tradycyjny,
8 – N/A
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 2 z 6
Opracował: Dział IT
(Telefon 61 642 93 43)
Przelewy24 – Specyfikacja techniczna instalacji
16 - wszystkie 24/7,
32 - użyj przedpłatę
p24_shipping
INT
N
Koszt dostawy/wysyłki/etc
p24_transfer_label *
STRING(20)
N
Opis pojawiający się w
tytule przelewu1
p24_api_version
STRING(5)
T
3.0b
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
Suma
wyliczana
poniżej
p24_encoding
STRING(15)
N
System
kodowania
przesyłanych znaków:
ISO-8859-2,
UTF-8,
Windows-1250
jednostkowa
systemie
kontrolna
wg
opisu
* - dostępne w wersji 3.1
3 Wynik transakcji
Adres URL: adres powrotny z transakcji
Parametry POST:
p24_merchant_id
INT
ID Sprzedawcy
p24_pos_id
INT
ID Sprzedawcy
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
1
2
nadany
użyta
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
Weryfikacja otrzymanego wyniku transakcji:
Adres URL: https://secure.przelewy24.pl/trnVerify
Parametry POST:
p24_merchant_id
INT
ID Sprzedawcy
p24_pos_id
INT
ID Sprzedawcy
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
Przelewy24 – Specyfikacja techniczna instalacji
Opracował: Dział IT
(Telefon 61 642 93 43)
4 Usługi WebServices
Adres serwera WebServices Przelewy24:
Encoded: https://secure.przelewy24.pl/external/wsdl/service.php?wsdl
Literal: https://secure.przelewy24.pl/external/wsdl/services.php?wsdl
Dokumentacja do pobrania ze strony www.przelewy24.pl
5 Informacje dodatkowe
5.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
5.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 3 – 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