Przelewy24
Transkrypt
Przelewy24
Opracował: Dział IT (Telefon 61 642 93 43) Przelewy24 – Specyfikacja techniczna instalacji Przelewy24 Specyfikacja techniczna instalacji Data: 2014-01-11 Wersja: 3.01 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 Unikalny identyfikator systemu Merchanta p24_amount INT T Kwota w groszach PLN, EUR, GBP, CZK p24_currency STRING(3) T p24_client_fee * INT N p24_description STRING(1024) T Opis transakcji p24_email STRING(50) T Email Klienta p24_client STRING(50) N** Imię i nazwisko Klienta z p24_address STRING(80) N** Adres Klienta p24_zip STRING(10) N** Kod pocztowy Klienta p24_city STRING(50) N** Miasto Klienta 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, 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 8 – N/A 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 STRING(5) T 3.01 p24_api_version 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 ** - pola wymagane dla płatności kartami płatniczymi, PayPal, FerBuy. Sumę kontrolną p24_sign obliczamy wg poniższego wzoru: p24_sign => to wartość funkcji MD5 z połączonych ze sobą pól: p24_session_id, p24_merchant_id, p24_amount oraz klucza CRC. Łącznikiem pól jest znak „|”. W panelu transakcyjnym, w zakładce „Moje dane” jest ciąg o nazwie „Klucz do CRC”. Wartość z tego pola (16 znaków alfanumerycznych) jest potrzebna do obliczania sumy kontrolnej. 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 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 – obliczana wg wzoru podanego wyżej, z pól: p24_session_id, p24_order_id, p24_amount i pola „Klucz CRC” nadany użyta 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 Numer transakcji przez Przelewy24 p24_sign STRING Suma kontrolna – obliczana wg wzoru podanego wyżej, z pól: p24_session_id, p24_order_id, p24_amount i pola „Klucz CRC” 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