dotpay_instrukcja_techniczna.pdf

Dział Pomocy Technicznej Dotpay

ul. Wielicka 72

30-552 Kraków

Tel. +48 126882600

Faks +48 126882649

E-mail: tech@dotpay.pl

INSTRUKCJA TECHNICZNA IMPLEMENTACJI PŁATNOŚCI v0.8.6

Przyjmowanie płatności od

klientów

Tryb testowy

Odbieranie informacji po

płatności

Informacje dodatkowe

Instrukcja techniczna implementacji płatności v0.8.6

Spis Treści

WSTĘP............................................................................................................................................................................3

I.PRZYJMOWANIE PŁATNOŚCI OD KLIENTÓW..........................................................................................................4

I.1 Wersja podstawowa................................................................................................................................................ 4

I.2 Wersja generowana................................................................................................................................................. 5

I.3 Wersja bezpośrednia............................................................................................................................................... 5

Tabela 1. (Podstawowe parametry przesyłane do serwisu Dotpay).........................................................................7

Tabela 2. (Dodatkowe parametry przesyłane do serwisu Dotpay)............................................................................8

II.TRYB TESTOWY.......................................................................................................................................................16

III.WYDAWANIE KODÓW DOSTĘPU PO PŁATNOŚCIACH INTERNETOWYCH I GOTÓWKOWYCH....................17

III.1 Generowanie 8-znakowego kodu - przesyłanie go do serwisu klienta.................................................................17

III.2 Generowanie nazwy użytkownika i hasła - przesłanie do serwisu klienta...........................................................17

III.3 Generowanie listy kodów..................................................................................................................................... 18

III.4 Konto kodów bezobsługowych............................................................................................................................ 18

III.5 Konfiguracja skryptów pobranych z serwisu panelu administracyjnego .............................................................19

III.6 Sprawdzenie poprawności konfiguracji usług kodów dostępu.............................................................................20

IV.ODBIERANIE INFORMACJI PO PŁATNOŚCI.........................................................................................................22

IV.1 Powiadomienia URLC........................................................................................................................................ 22

Tabela 3. (Parametry odbierane z serwisu Dotpay po płatności)...........................................................................22

IV.2 Bezpieczne odbieranie powiadomień URLC...................................................................................................... 25

V.INFORMACJE DODATKOWE...................................................................................................................................26

DZIENNIK ZMIAN..........................................................................................................................................................27

Dział Pomocy Technicznej Dotpay : ul. Wielicka 72, 30-552 Kraków, Tel. +48 126882600, tech@dotpay.pl

- 2 -

Instrukcja techniczna implementacji płatności v0.8.6

WSTĘP

Niniejszy dokument opisuje interfejs systemu płatności oferowanego przez serwis Dotpay i przeznaczony jest zarówno

dla podmiotów zainteresowanych ofertą serwisu, jak i osób zajmujących się wdrożeniem systemu.

W dokumencie zastosowano następujące pojęcia i oznaczenia:

linki aktywne

Hiperłącze przenoszące poza obszar dokumentu.

linki nieaktywne

Brak akcji po kliknięciu w hiperłącze, oznaczenie w celu łatwiejszej identyfikacji.

Sekcja → opcja1 → opcja2 Ścieżka wskazująca opcję konfiguracyjną konta Dotpay (opcje dostępne po

zalogowaniu do panelu na stronie: https://ssl.dotpay.pl/login ).

nazwa

nazwa=wartość

Kod źródłowy, nazwa pliku lub parametr przesłany do serwisu Dotpay podczas

inicjowania procesu płatności lub odebrany w powiadomieniu o stanie transakcji,

hiperłącze przenosi do opisu parametru w tej instrukcji.

Kontrahent / Sprzedawca

Użytkownik serwisu Dotpay pobierający płatność lub właściciel portalu, sklepu czy

strony internetowej, na której rozpoczyna się proces płatności.

Klient / Kupujący

Osoba dokonująca wpłaty na rzecz Kontrahenta za pośrednictwem serwisu

transakcyjnego Dotpay.

Dział Pomocy Technicznej Dotpay : ul. Wielicka 72, 30-552 Kraków, Tel. +48 126882600, tech@dotpay.pl

- 3 -

Instrukcja techniczna implementacji płatności v0.8.6

I. PRZYJMOWANIE PŁATNOŚCI OD KLIENTÓW

Dostępne są trzy metody przyjmowania płatności od Klientów. Dwie pierwsze (wersja podstawowa oraz wersja

generowana) przeznaczone są dla Sprzedawców, którzy nie posiadają sklepów lub serwisów zintegrowanych

z systemem Dotpay. Trzecia metoda (wersja bezpośrednia) przeznaczona jest dla sklepów oraz serwisów, na których

rozpoczyna się proces płatności (np. Klient składa zamówienie na towar).

Dla popularnych sklepów internetowych przygotowane zostały przykładowe moduły, które pozwalają na łatwą

integrację z systemem płatności Dotpay. Można je pobrać po zalogowaniu do serwisu Dotpay w sekcji Pobierz →

niezbędne pliki . Pobrany moduł należy zainstalować zgodnie z dołączonym do niego opisem instalacji.

I.1 Wersja podstawowa

Klienci dokonujący wpłaty na rzecz Sprzedawcy o określonym numerze ID (np. ID=100 ) mogą skorzystać z opcji

" Zapłać sprzedawcy " dostępnej na stronie głównej serwisu http://dotpay.pl lub bezpośrednio po wprowadzeniu

adresu: https://ssl.dotpay.pl/pay.php .

Po wprowadzeniu w/w linku w pasku przeglądarki Klient wypełnić powinien formularz określający następujące dane:

ID sprzedawcy (np. 100)

kwotę transakcji (np. 12.42)

walutę transakcji (np. PLN)

opis transakcji (np. Zapłata za fakturę VAT 12345/2009)

Ta metoda jest przydatna również w przypadku gdy zaistnieje potrzeba udostępnienia Kupującemu samodzielnej

decyzji o wysokości wpłaty i opisie płatności (np. w przypadku dotacji/wsparcia).

Dowolne z powyższych danych można zapisać w adresie URL, np. aby wyeliminować możliwość błędnego

wprowadzenia przez Klienta numeru ID konta Sprzedawcy, można zapisać ten numer w treści linku. Należy w takim

przypadku zdefiniować następujący adres URL:

https://ssl.dotpay.pl/?id=100

W tym adresie numer sprzedawcy przekazywany jest do formularza płatności Dotpay za pomocą metody GET. Na tej

samej zasadzie przekazać można także inne parametry wpłaty - w poniższym przykładzie do formularza płatności

przekazywana jest również kwota i opis :

https://ssl.dotpay.pl/?id=100&kwota=123.00&opis=Test

Ponieważ nie przesłano parametru waluta , transakcja odbędzie się w walucie domyślnej dla konta o ID 100. Opis

pozostałych parametrów, które można w ten sposób przekazać do formularza płatności Dotpay, znajduje się w dalszej

części instrukcji ( Tabela 1 oraz Tabela 2) .

Dział Pomocy Technicznej Dotpay : ul. Wielicka 72, 30-552 Kraków, Tel. +48 126882600, tech@dotpay.pl

- 4 -

Instrukcja techniczna implementacji płatności v0.8.6

I.2 Wersja generowana

Po zalogowaniu w serwisie Dotpay można skorzystać z menu Inne → generowanie wpłat . Menu to pozwala na

określenie danych takich jak: kwota , waluta , opis oraz jezyk . Kreator pozwala również zdecydować czy po kliknięciu

w link ma być dostępna opcja płatności za pomocą karty płatniczej. Wygenerowanie wpłaty oznacza utworzenie

specjalnego klucza, którego wywołanie pozwoli na odgórne zdefiniowanie wymienionych parametrów, a tym samym

uprości proces płatności.

Wygenerowane w ten sposób klucze można przeglądać oraz modyfikować ich właściwości (np. kwota ) w menu Inne

→ przeglądanie wpłat .

Przykład klucza: I89RJLN3W38C2QWR4E9LLVXI7HYS2L9A

Dla tak określonego klucza stronę płatności można wywołać korzystając z następującego linku:

https://ssl.dotpay.pl/?pid=I89RJLN3W38C2QWR4E9LLVXI7HYS2L9A

W przypadku, gdy nie zostanie zdefiniowany język płatności lub gdy zdefiniowany uprzednio język zostanie usunięty,

zastosowanie parametru lang (lub jezyk ) pozwoli na wybór języka, w jakim wyświetlona ma zostać strona płatności.

Przykład wywołania stron płatności z dodatkowym parametrem lang=en w celu zaprezentowania formularza w języku

angielskim:

https://ssl.dotpay.pl/?pid=I89RJLN3W38C2QWR4E9LLVXI7HYS2L9A&lang=en

Przygotowany link z kluczem można wykorzystywać z powodzeniem na aukcjach internetowych, gdzie umieszczenie

go na stronie aukcji, lub przesłanie w wiadomości e-mail do Kupującego, pozwoli na szybkie otrzymanie płatności.

Utworzony po zalogowaniu do serwisu Dotpay link z kluczem może być wykorzystywany wielokrotnie.

W sekcji Obsługa aukcji znajdują się dodatkowe narzędzia ułatwiające Sprzedawcom obsługę aukcji internetowych.

Za pomocą narzędzia Obsługa aukcji → generuj aukcje Sprzedawca może przesłać do Kupującego e-mail

zawierający specjalny link do wpłaty. Link klucz analogiczny do omawianego powyżej. Po kliknięciu w taki link

Kupującemu zostanie wyświetlony wypełniony formularz płatności, za pośrednictwem którego będzie mógł dokonać

wpłaty wybranym przez siebie kanałem transakcyjnym (np. przelewem lub kartą).

Za pomocą narzędzia Obsługa aukcji → generuj kod buttona Sprzedawca może wygenerować kod HTML, który po

wstawieniu w treści aukcji wyświetli element graficzny przekierowujący Kupującego na stronę zawierającą wypełniony

formularz płatności. Kod ten można wykorzystać w każdym serwisie aukcyjnym zezwalającym na użycie tagu <FORM>

w treści aukcji internetowej.

I.3 Wersja bezpośrednia

Wersja bezpośrednia polega na integracji serwisu Sprzedawcy z systemem płatności Dotpay.

W tej wersji Klient po złożeniu zamówienia zostaje przekierowany z serwisu Sprzedawcy do formularza płatności

Dotpay.

Klient znajdujący się na stronie Sprzedawcy, po kliknięciu na przycisk potwierdzający chęć zapłaty (np. " Zapłać przez

Dotpay ") powinien zostać przekierowany na adres https://ssl.dotpay.pl/ lub https://ssl.dotpay.eu/ .

Dział Pomocy Technicznej Dotpay : ul. Wielicka 72, 30-552 Kraków, Tel. +48 126882600, tech@dotpay.pl

- 5 -

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: