INSTRUKCJA TECHNICZNA USŁUG PREMIUM SMS I MMS DOŁADOWAŃ I PAY PER CALL

Transkrypt

1 Biuro Obsługi Klienta Dotpay ul. Wielicka 72, Kraków tel.: faks: INSTRUKCJA TECHNICZNA USŁUG PREMIUM SMS I MMS DOŁADOWAŃ I PAY PER CALL I. Usługi Premium SMS II. Usługi Premium MMS III. Doładowania IV. Pay Per Call

2 SPIS TREŚCI I. USŁUGI PREMIUM SMS Informacje podstawowe Kody dostępu Generowanie listy 8-mio znakowych kodów Kod generowany i dopisywany do listy kodów. Sprawdzanie kodów Treśd zwrotna Treści przesyłane na wskazany adres lub do skryptu SMS typu Wappush Infoserwisy Informacje dodatkowe...14 II. USŁUGI PREMIUM MMS Informacje podstawowe Przesyłanie treści MMS do skryptu lub na wskazany adres Odbiór parametrów przesyłanych do skryptu internetowego MMS za SMS Definiowanie usługi Pobieranie treści obiektów do wysyłki MMS Informacje dodatkowe...24 III. DOŁADOWANIA TELEFONÓW KOMÓRKOWYCH...24 IV. USŁUGA PAY PER CALL...25 Strona 2

3 I. USŁUGI PREMIUM SMS Niniejszy dokument jest instrukcją techniczną opisującą możliwości wykorzystania usług opartych o krótkie wiadomości tekstowe typu SMS o podwyższonej płatności (Premium Rate SMS). Strona 3 1. Informacje podstawowe Serwis Dotpay.pl udostępnia swoim klientom możliwośd obsługiwania wiadomości SMS odbieranych na następujących numerach dostępowych (konektorach): Konektor Wartośd netto za 1 wiadomośd SMS zł zł zł zł zł zł zł EUR Bieżące informacje dotyczące zasad rozliczeo pomiędzy kontrahentem a serwisem Dotpay można znaleźd w Regulaminie serwisu Dotpay. UWAGA! Każda tworzona usługa SMS wymaga akceptacji ze strony serwisu Dotpay. Dlatego prosimy o umieszczenie na Paostwa stronach odpowiednich informacji określonych w regulaminie usług SMS. W przypadku braku informacji, braku opisu lub podania nieprawidłowych danych usługa SMS nie zostanie aktywowana. 2. Kody dostępu Serwis Dotpay udostępnia użytkownikom kilka możliwości wykorzystania usług SMS, za pomocą których możliwe jest przygotowanie ograniczonego dostępu do informacji. Usługa ta jest wykorzystywana głównie do płatności za dostęp do archiwum danych, dostęp do ograniczonej strefy serwisu, dostępu do galerii i innych podobnych usług. Za pomocą tej usługi klient po wysłaniu SMSa o określonej treści otrzyma informację zwrotną, która będzie zawierała kod uprawniający do skorzystania z usługi o ograniczonym dostępie. Usługi sprawdzania kodów dostępowych można podzielid na dwie podstawowe grupy:

4 2.1. Generowanie listy 8-mio znakowych kodów Za pomocą tej usługi kontrahent określa wygenerowanie określonej listy ośmioznakowych kodów (np kodów). Usługa ta wymaga od kontrahenta przygotowania we własnym zakresie systemu weryfikacji poprawności oraz ważności kodu (jeśli kod jest czasowo ograniczony). Przy tworzeniu tej usługi SMS należy określid: - nazwę usługi (np. Dostęp do galerii), - ilośd kodów jaka ma się wygenerowad, - identyfikator usługi (jest to treśd SMSa jaka klient będzie musiał wysład), - wartośd przesłanej wiadomości SMS (można wybrad więcej niż jedną wartośd, np. kod za 3 i za 9 zł netto), - jeżeli serwis zawiera materiały o charakterze erotycznym, to koniecznie należy zaznaczyd odpowiednią opcję. Strona 4 Dla każdej tworzonej usługi SMS należy koniecznie określid adres internetowy pod którym znajduje się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie usługi. Wygenerowany zestaw kodów należy pobrad z serwisu Dotpay, a następnie umieścid we własnym serwisie. Proponowanym rozwiązaniem jest zastosowanie bazy danych (np. MySQL) w której przechowywana jest lista kodów dostępowych. Cały mechanizm weryfikacji powinien byd oparty o bazę danych z kodami. W tym przypadku nie ma możliwości weryfikacji kodu za pośrednictwem serwisu Dotpay. Serwis Dotpay po otrzymaniu zgłoszenia poprzez otrzymanie od klienta wiadomości SMS o odpowiedniej treści wysyła SMS zwrotny zawierający kod dostępu. Wysłany kod jest pierwszym z listy kodów znajdujący się na wygenerowanej uprzednio liście kodów. Kod po wysłaniu jest kasowany. Gdy na liście kodów będzie mniej niż 50 niewykorzystanych kodów to serwis Dotpay wyśle powiadomienie do kontrahenta z informacją o niskiej ilości kodów i prośbie dogenerowania dodatkowych kodów. Nowo wygenerowane kody w obrębie jednej usługi SMS dopisywane są na koocu istniejącej listy kodów Kod generowany i dopisywany do listy kodów. Sprawdzanie kodów Niniejsza usługa jest bardzo podobna do przedstawionej w pkt. 1. Jedyną różnicą jest fakt, że kontrahent nie musi przygotowywad samodzielnie obsługi sprawdzania kodów. Wystarczy, że skorzysta z dostarczonego przez Dotpay skryptu do sprawdzania poprawności i ważności kodu. Aby skorzystad z tego rozwiązania kontrahent musi zdefiniowad usługę SMS w menu: Serwisy SMS usługi SMS Dodaj nową usługę SMS zwracający kod dostępu do usługi

5 z listy typów usług należy wybrad: Kod generowany i dopisywany do listy kodów. Sprawdzanie kodów w Dotpay. Podczas tworzenia usługi należy wprowadzid następujące informacje o usłudze: - nazwa usługi, - adres IP serwera, który będzie wysyłał zapytania do serwisu Dotpay celem sprawdzenia czy dany kod jest prawidłowy czy nie, - identyfikator usługi (jest to treśd SMSa jaką będzie musiał wpisad użytkownik usługi), - wartośd 1 kodu (należy zaznaczyd jedną lub więcej opcji), - jeżeli serwis zawiera materiały o charakterze erotycznym, to koniecznie należy zaznaczyd odpowiednią opcję, - okres ważności kodu (przez ile czasu od momentu pierwszego skorzystania kod ma byd ważny). Strona 5 Adres IP serwera wysyłającego polecenie sprawdzenia kodu może byd zapisane w postaci jednego adresu IP, kilku adresów IP oddzielonych znakiem przecinka lub możliwe jest podanie częściowego adresu zawierającego znak * jako maski dopasowującej adres IP (np. w przypadku gdy serwer wysyłający zapytanie ma zmienny adres IP). Przykłady użycia podania adresu(ów) IP serwera: 1) w tym przypadku informacje o ważności kodu będą udostępniane jedynie serwerowi zgłaszającemu się z tego numeru IP 2) , w tym przypadku informacje będą zwracane dla serwera zgłaszającego się z jednego z 2 wyżej wymienionych adresów IP 3) * - kod będzie sprawdzany dla serwera identyfikującego się przynajmniej tymi dwoma numerami sieci. Jest to równoważny zapis dla adresu: *.* 4) , * - akceptowane będą zapytania z określonego adresu IP oraz z całej puli adresów sieci * 5) * - akceptowane będą zapytania o sprawdzenie kodu z każdego serwera Dla każdej tworzonej usługi SMS należy koniecznie określid adres internetowy pod którym znajduje się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie usługi. Określenie czasu ważności kodu ma na celu zdefiniowanie przez ile czasu klient może wykorzystywad dany kod (jednokrotnie / wielokrotnie). W przypadku kodów jednorazowych po skorzystaniu z kodu serwis Dotpay kasuje wykorzystany kod. Klient, który otrzymał kod, ale nie wykorzystał go od razu może z kodu skorzystad w dowolnym momencie. Czas ważności kodu naliczany jest dopiero od momentu pierwszego skorzystania z kodu. Aby skorzystad z tej usługi klient powinien wysład SMSa o następującej treści: AP.IDENTYFIKATOR lub

6 AP IDENTYFIKATOR gdzie zamiast słowa identyfikator należy wpisad treśd identyfikatora utworzonej usługi. Wiadomośd SMS należy wysład na numer zdefiniowany podczas zakładania usługi, przy czym lista numerów, na które można wysyład wiadomości SMS została przedstawiona w punkcie 1. Zakładamy, że utworzono usługę o identyfikatorze DOSTEP, gdzie wartośd 1 kodu to 2 zł netto. Prawidłowy SMS powinien byd wysłany na numer o następującej treści: AP.DOSTEP Serwis Dotpay dostarcza zestaw skryptów pozwalających na sprawdzanie poprawności i ważności kodu. Skrypty dostępne są w dziale niezbędne pliki Skrypt obsługi kodów automatycznych (karty, przelewy, sms). Po pobraniu i rozpakowaniu pliku kontrahent ma do dyspozycji 3 zestawy skryptów do sprawdzania kodów. a) standard jest to podstawowa wersja skryptu oparta o funkcje fopen() języka PHP, b) fsocks skrypty oparte o funkcje fsockopen() języka PHP, c) curl skrypty oparte o bibliotekę curl języka PHP. Strona 6 Kontrahent powinien wybrad właściwą wersję skryptu w zależności od konfiguracji serwera WWW na którym znajduje się serwis. Częstą praktyką administratorów serwerów jest zablokowanie niektórych funkcji języka PHP (m.in. fopen() ) dlatego jeżeli skrypt nie działa, to należy skorzystad z następnego zestawu skryptów. Konfiguracja skryptów pobranych z serwisu Dotpay. Podstawowym plikiem konfiguracyjnym jest sprawdz.php. Najważniejsze parametry, jakie należy określid w tym pliku to: $id= określa ID kontrahenta zarejestrowanego w serwisie Dotpay $code= określenie identyfikatora lub grupy identyfikatorów dla których zdefiniowano usługi SMS $type= określenie typu usługi dla której będzie sprawdzany kod. Możliwe wartości to: sms, c1 $page= wskazuje jaki plik lub adres internetowy ma został wykorzystany po wprowadzeniu prawidłowego pliku Przykład konfiguracji pliku sprawdz.php: Zakładamy, że kontrahent utworzył usługę SMS o następujących właściwościach: a) ID kontrahenta: 99 b) Nazwa usługi: Dostęp do archiwum c) Identyfikator: ARCH d) Cena 1 kodu: 3 PLN e) Okres ważności kodu: 2h f) Po wprowadzeniu prawidłowego kodu ma zostad wyświetlona strona o nazwie strona2.php Dla takiej usługi plik sprawdz.php ma następującą postad:

7 $id=99; $code= ARCH ; $type= sms ; $page= strona2.php ; Aby zablokowad możliwośd wykorzystania strony2.php bezpośrednio (czyli bez użycia kodu) należy na samym początku pliku strona2.php wprowadzid następujący zapis: <?php include sprawdzacz.php ;?> Strona 7 Jeżeli kontrahent ma więcej usług SMS dotyczących tego samego serwisu to można nakazad sprawdzanie kodów w więcej niż jednej usłudze podając kilka identyfikatorów usług. Np. kontrahent założył 2 usługi SMS: a) dostęp do archiwum za 3 zł o identyfikatorze ARCH3, b) dostęp do archiwum za 5 zł o identyfikatorze ARCH5. W tym przypadku wartośd parametru $code ma następującą postad: code= ARCH3,ARCH5 ; 3. Treśd zwrotna Usługi SMS pozwalające na przesłanie treści zwrotnej polega na zdefiniowaniu jednej lub określonej grupy tekstów zwracanych klientowi po otrzymaniu wiadomości SMS o odpowiedniej treści. Dodatkowy parametr zawarty w treści SMSa pozwala na określenie, którą informację klient chce pozyskad. Przykład wykorzystania: Zakładamy, że kontrahent utworzył usługę przekazywania treści z ogłoszenia o identyfikatorze OGL. Następnie określamy, jakie treści mają byd przesłane po przesłaniu wiadomości SMS o parametrach 1 oraz 6. a) przykład 1: Klient wysyła SMSa o treści: AT.OGL.1 na zdefiniowany uprzednio numer w odpowiedzi klient otrzyma treśd, która została zdefiniowana pod numerem 1 b) przykład 2: Klient wysyła SMSa o treści: AT.OGL.6 na zdefiniowany uprzednio numer w odpowiedzi klient otrzyma treśd, która została zdefiniowana pod numerem 6 Aby utworzyd usługę należy określid następujące dane: - nazwa usługi, - identyfikator usługi (jest to treśd SMSa jaką będzie musiał wpisad użytkownik usługi), - wartośd 1 treści (należy zaznaczyd jedną lub więcej opcji), - jeżeli serwis zawiera materiały o charakterze erotycznym, to koniecznie należy zaznaczyd odpowiednią opcję.

8 Dla każdej tworzonej usługi SMS należy koniecznie określid adres internetowy pod którym znajduje się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie usługi. Aby dokonad zdefiniowania nowych treści zwrotnych należy w odpowiednim oknie wprowadzid tekst postaci: numer_usługi=pełna_treśd_smsa gdzie: numer usługi - dowolny numer określony przez kontrahenta pełna treśd SMSa - tekst nie dłuższy niż 160 znaków zawierający tylko znaki alfanumeryczne (tekst nie może zawierad polskich znaków!) Strona 8 Przykład definicji: Zakładamy, że utworzono usługę o identyfikatorze INFO gdzie wartośd jednej treści to 5 zł netto. Poniżej zaprezentowano, jakie usługi zostały zdefiniowane: 0=Zapomniales okreslic numer uslugi! 1=Dostep do archiwum znajduje się na stronie 2=Sprzedam uzywany spadochron. 3=Kontakt do Joli to jola@onet.pl Prawidłowe skorzystanie z usługi będzie miało miejsce, gdy klient wyśle SMSa na numer o treści: AT.INFO.2 Dla tak otrzymanego SMSa nadawca otrzyma po chwili wiadomośd: Sprzedam uzywany spadochron. UWAGA! W przypadku gdy klient zapomni lub nie wprowadzi parametru określającego numer usługi, to zostanie mu zwrócona treśd, która jest pierwsza na zdefiniowanej liście. Dla powyższego przykładu, po wysłaniu SMSa o treści: AT.INFO nadawca otrzyma wiadomośd zapisaną pod numerem 0 (zero) dlatego, że jest pierwsza na liście: Zapomniales okreslic numer uslugi! Aby zastąpid istniejący wpis należy podad nową definicję treści wprowadzając numer usługi dla której chcemy dokonad zmiany. Możliwe jest dokonanie zmiany dla więcej niż jednej treści. W tym przypadku należy podad w nowej linii kolejną definicję zmieniającą treśd zapisaną pod tym samym numerem. Aby usunąd wskazaną usługę należy zaznaczyd ją i skorzystad z guzika Usuo. Przykład dla zmiany wpisu nr 2: 2=Sprzedam telewizor kolorowy

9 4. Treści przesyłane na wskazany adres lub do skryptu Głównym przeznaczeniem tej usługi jest wprowadzenie możliwości bezpośredniego przesłania treści wiadomości SMS do skryptu internetowego lub na wskazany adres w postaci wiadomości tekstowej. Usługę tą można z powodzeniem wykorzystad do wszelkiego rodzaju ogłoszeo bezpośrednich (wprost z telefonu komórkowego) jak również do czatów i blogów. Strona 9 Aby utworzyd usługę należy określid następujące dane: - nazwa usługi, - identyfikator usługi (jest to treśd SMSa jaką będzie musiał wpisad użytkownik usługi), - wartośd 1 treści (należy zaznaczyd jedną lub więcej opcji), - jeżeli serwis zawiera materiały o charakterze erotycznym, to koniecznie należy zaznaczyd odpowiednią opcję. Dla każdej tworzonej usługi SMS należy koniecznie określid adres internetowy pod którym znajduje się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie usługi. Po utworzeniu usługi należy dokonad konfiguracji określając następujące dane: a) czy treśd SMSa ma byd przekazana na adres podany podczas rejestracji, b) czy treśd SMSa ma byd przekazana na adres inny niż podany podczas rejestracji, c) zdefiniowad adres internetowy do skryptu (np. CGI lub PHP), na jaki zostanie wysłany komplet informacji opisujący zdarzenie otrzymania wiadomości SMS. Dla przypadku c) realizowana jest przesyłka do wskazanego skryptu internetowego za pośrednictwem protokołu http(s) przy wykorzystaniu metody POST. Przekazywane parametry do skryptu to: fulltext pełna treśd otrzymanego SMSa (np. TC.NAZWA.tresc_smsa) text - treśd otrzymanego SMSa bez identyfikatora usługi (np. tresc_smsa) ident identyfikator usługi service typ usługi number numer na jaki wysłano SMSa sender numer telefonu nadawcy code kod potwierdzający przyjęcie SMSa date data otrzymania SMSa. Parametr code określa kod jaki został wysłany do nadawcy. Jest to kod potwierdzający otrzymanie SMSa przez serwis Dotpay. Kod ten jest generowany losowo. Po otrzymaniu przesyłki skrypt kontrahenta powinien odpowiedzied słowem OK. W przypadku skryptu PHP można to zrealizowad za pośrednictwem niniejszego kodu: <?php # zapisujemy do bazy danych informacje # o otrzymanych parametrach

10 $zapytanie = mysql_query( INSERT INTO SMS (date, text, ident, service, number, sender, code) VALUES (.$_POST* date +.,.$_POST* text +.,.$_POST* fulltext +.,.$_POST* ident +.,.$_POST* service +.,.$_POST* number +.,.$_POST* sender +.,.$_POST* code +. ); echo OK ; exit;?> 0 Oczywiście wcześniej należy zdefiniowad w bazie danych MySQL tabelę o nazwie SMS. Przykład wykorzystania usługi: TR.OGL.Sprzedam samochod ciezarowy marki Star. Wiadomosc: tel TR.BLOG.Witajcie! Dzisiaj pisze do Was wiadomosc z gor! Jest wspaniale, pogoda dopisuje! No to hejka! 5. SMS typu Wappush Usługi SMS typu WAPPUSH pozwalają na przesłanie zakładki WAP o określonej nazwie i linku. Usługa ta pozwala na udostępnienie klientom możliwości łatwego pobrania obrazków lub plików multimedialnych na telefon komórkowy za pośrednictwem protokołu WAP. Usługa wiadomości SMS typu WAPPUSH dostępna jest jedynie dla kontrahentów zarejestrowanych w serwisie Dotpay reprezentujących osoby prawne lub firmy. Przykład wykorzystania: Zakładamy, że kontrahent utworzył usługę przekazywania zakładki WAP o nazwie Zdjęcia o identyfikatorze ZDECIA Następnie określamy, jakie zakładki mają byd wysłane dla usług o parametrach 2 i 5. a) przykład 1: a. Klient wysyła SMSa o treści: RS.ZDJECIA.2 na zdefiniowany uprzednio b. w odpowiedzi klient otrzyma zakładkę, która została zdefiniowana pod numerem 1 b) przykład 2: a. Klient wysyła SMSa o treści: RS.ZDJECIA.5 na zdefiniowany uprzednio numer w odpowiedzi klient otrzyma zakładkę oraz link, która został zdefiniowany pod numerem 5 Aby utworzyd usługę należy określid następujące dane: - nazwa usługi, - identyfikator usługi (jest to treśd wiadomości SMS, jaką będzie musiał wpisad użytkownik usługi), - wartośd 1 zakładki (należy zaznaczyd jedną lub więcej opcji),

11 - jeżeli serwis zawiera materiały o charakterze erotycznym, to koniecznie należy zaznaczyd odpowiednią opcję. Dla każdej tworzonej usługi SMS należy koniecznie określid adres internetowy pod którym znajduje się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie usługi. 1 Aby dokonad zdefiniowania nowych zakładek WAP należy w odpowiednim oknie wprowadzid tekst postaci: numer_usługi=nazwa_zakładki=link_do_obiektu gdzie: numer_usługi - dowolny numer określony przez kontrahenta nazwa_zakładki treśd określająca zakładkę WAP link_do_obiektu - tekst będący linkiem do obiektu, który klient będzie mógł pobrad po skorzystaniu z otrzymanej zakładki. UWAGA! Łączna długośd nazwy zakładki i linku do obiektu nie mogą przekraczad 80 znaków! Przykład definicji: Zakładamy, że utworzono usługę o identyfikatorze GRY gdzie wartośd jednej treści to 9 zł netto. Poniżej zaprezentowano, jakie zakładki zostały zdefiniowane: 0=Zapomninalski= 1=Strzelanka= 2=Robocik= Prawidłowe skorzystanie z usługi będzie miało miejsce, gdy klient wyśle SMSa na numer o treści: RS.GRY.2 Dla tak otrzymanego SMSa nadawca otrzyma po chwili zakładkę WAP o nazwie Robocik zawierającą link UWAGA! W przypadku gdy klient zapomni lub nie wprowadzi parametru określającego numer usługi, to zostanie mu zwrócona zakładka, która jest pierwsza na zdefiniowanej liście. Dla powyższego przykładu, po wysłaniu SMSa o treści: RS.GRY nadawca otrzyma zakładkę zawierająca link do dzwonka zapisanego w formacie mid. Aby zastąpid istniejący wpis należy podad nową definicję zakładki wprowadzając numer usługi dla której chcemy dokonad zmiany. Możliwe jest dokonanie zmiany dla więcej niż jednej zakładki równocześnie. W tym przypadku należy podad w nowej linii kolejną definicję zakładki zmieniającą

12 nazwę oraz link, która zapisana jest pod numerem do zmiany. Aby usunąd wskazaną usługę należy zaznaczyd ją i skorzystad z guzika Usuo. Przykład dla zmiany wpisu nr 1: 2=Puzzle= Infoserwisy Usługa Infoserwisy w Dotpay przeznaczona jest do wysyłania określonych treści do klientów za pomocą wiadomości SMS. Zasada działania jest następująca: 1. klient wysyła wiadomośd SMS o wskazanej treści rejestrując się tym samym w usłudze, 2. w zależności od stawki wysłanej wiadomości SMS przydzielanych jest od 2 do 30 wiadomości zwrotnych, w których zawarte są zamówione informacje odsyłane do nadawcy zgodnie z ustalonym w usłudze harmonogramem. W poniższej tabeli przedstawiono ilośd wiadomości zwrotnych wysyłanych do nadawcy SMS w zależności od stawki: Stawka Numer konektora 1zł zł zł zł zł zł Ilośd wysyłanych wiadomości SMS Tworzenie nowej usługi Aby utworzyd nową usługę Infoserwisy należy: 1. zalogowad się do serwisu Dotpay, 2. z menu Serwisy SMS wybrad opcje Usługi SMS a następnie Dodaj nową usługę, 3. z listy wyboru należy wybrad Infoserwisy SMS w Dotpay (w tym momencie pojawi się okienko z prośbą o wprowadzenie danych definiujących tworzoną usługę SMS), 4. należy wprowadzid nazwę usługi, która określi co to jest za usługa, 5. identyfikator usługi, który będzie jednocześnie treścią SMSa jaką klient będzie musiał wysład, aby skorzystad z tej usługi, np. OGLOSZENIA, 6. należy określid stawkę za 1 wiadomośd SMS przesłaną przez nadawcę i tym samym ilośd informacji zwrotnych. Do dokonania wyboru należy skorzystad z powyższej tabeli. wybrano stawkę za 2zł, czyli 2 treści będą wysłane do nadawcy wiadomości SMS

13 7. informacją wymaganą jest podanie dokładnego adresu do strony internetowej gdzie zawarta jest informacja opisująca jak skorzystad z usługi, zgodnie z regulaminem usług SMS. Na stronie musi pojawid się informacja dla klienta ile otrzyma wiadomości zwrotnych, 8. należy podad krótki opis utworzonej usługi, do czego służy, jak i gdzie odszukad informacje na stronie kontrahenta, 9. po skorzystaniu z guzika Utwórz usługę następuje przejście do konfiguracji usługi. W ten sposób utworzono przykładową usługę, w której klient powinien wysład SMSa o treści NJ.OGLOSZENIA na numer W zamian otrzyma 2 treści zwrotne. 3 Konfiguracja nowej lub istniejącej usługi Aby skonfigurowad utworzoną usługę Infoserwisów należy określid następujące dane: a) wysyłane treści do nadawcy wiadomości SMS, b) określid w jakim przedziale godzinowym mają zostad dostarczone wiadomości infoserwisowe, c) określid co ile dni mają byd wysłane wiadomości (od 1 do 7). W celu dodania nowej treści zwrotnej należy w okienku Dodaj / zmodyfikuj nowe treści: wprowadzid następujące informacje: a) numer treści zwrotnej (od 1 do maksymalnej ograniczonej wartością stawki za SMS), b) treśd wiadomości nie przekraczająca 160 znaków alfanumerycznych (bez polskich znaków). Przykład wprowadzenia informacji zwrotnej dla usługi o wartości 2zł netto (czyli SMS wysłany na numer 72068): 1=To jest pierwsza wiadomośd zwrotna infoserwisu 2=A to jest druga wiadomośd infoserwisu Po skorzystaniu z guzika *Dodaj/Zmieo+ dane zostają zapamiętane. Efekt zapamiętania można zobaczyd w liście treści zwracanych. W przypadku pominięcia treści zwrotnej o określonym numerze wiadomośd nie zostanie wysłana do nadawcy. Np. gdy klient zamówi abonament otrzymywania informacji sportowych, gdzie treści mają byd wysyłane do nadawcy co dwa dni, to w takim przypadku należy określid treśd co drugiej usługi infoserwiu: 1=wygrana 1:0 dla Polski 3=Mecz koszykowki zakonczyl sie remisem 5=Wypadek podczas wyscigow zuzlowych Aby usunąd dany wpis należy wprowadzid numer usługi i znak równości bez treści.

14 Usuwamy treśd zapisaną pod numerem 3: 3= UWAGA! Każda zmiana treści lub wprowadzenie nowej treści ma skutek natychmiastowy. Jeśli wiadomośd o treści XXXXX miała zostad wysłana do nadawcy, a została zmieniona przez właściciela usługi przed wysłaniem na treśd YYYY to gdy nadejdzie czas wysyłki to zostanie odesłana wiadomośd po zmianie, czyli YYYY. 4 Konfiguracja zaawansowana Możliwe jest wprowadzenie zmiennego terminu wysyłanej wiadomości dla każdej określonej treści. Zatem pomimo określenia jednego globalnego terminu wysyłek, możliwe jest wprowadzenie terminów dla każdej treści z osobna. Aby tego dokonad należy wprowadzid numer usługi oraz literę określająca termin wysłania treści zgodnie z oznaczeniem z tabeli. Terminy przedstawione są w poniższej tabeli: Litera Termin A 1:00-6:00 B 6:00-9:00 C 9:00-12:00 D 12:00-16:00 E 16:00-19:00 F 19:00-22:00 G 22:00-01:00 Klient zamówił 5 wiadomości zwrotnych. Chcemy, aby klient otrzymał 3 wiadomości zwykle o 9:00 rano, jedną o 16:00 i jedną o 19:00. W tym celu określamy, że terminem wysyłania wiadomości jest 9:00-12:00, a następnie wprowadzamy definicje treści następująco: 1=ogloszenie 1: poszukujemy hydraulika na terenie miasta Warszawy 2=ogloszenie 2: poszukujemy mechanika na terenie miasta Wroclawia 3=ogloszenie 3: sprzedam pozytywke 4E=ogloszenie 4: poszukujemy barmana do pracy w PUBie 5F=Zyczymy milego wieczoru 7. Informacje dodatkowe

15 Adres IP serwera Dotpay to: lub Z tych adresów wywoływane są skrypty kontrahentów, dla których nastąpiło przesłanie treści wiadomości SMS lub inna forma powiadomienia. 5 II. USŁUGI PREMIUM MMS 1. Informacje podstawowe

16 Serwis Dotpay udostępnia swoim klientom możliwośd obsługiwania wiadomości MMS odbieranych na następujących numerach dostępowych (konektorach): Konektor Wartośd netto za 1 wiadomośd MMS zł zł 6 Odbiór wiadomości SMS udostępniony jest na następujących numerach dostępowych (konektorach): Konektor Wartośd netto za 1 wiadomośd MMS zł zł zł zł zł zł Bieżące informacje dotyczące zasad rozliczeo pomiędzy kontrahentem a serwisem Dotpay można znaleźd w Regulaminie serwisu Dotpay. UWAGA! Każda tworzona usługa MMS wymaga akceptacji ze strony serwisu Dotpay. Dlatego prosimy o umieszczenie na Paostwa stronach odpowiednich informacji określonych w regulaminie usług SMS i MMS. W przypadku braku informacji, braku opisu lub podania nieprawidłowych danych usługa SMS oraz MMS nie zostanie aktywowana lub zostanie skasowana. 2. Przesyłanie treści MMS do skryptu lub na wskazany adres Serwis Dotpay udostępnia użytkownikom usługę odbioru wiadomości MMS, a następnie przesłania całej zawartości wiadomości do skryptu internetowego użytkownika lub na adres podany podczas konfiguracji usługi. Aby dodad nową usługę należy z menu Serwisy SMS/MMS wybrad podmenu usługi MMS a następnie Dodaj nową usługę MMS. Dla tej usługi należy wybrad typ usługi: MMS przekazywany do skryptu lub na a następnie zaakceptowad guzikiem Wybierz. Przy zakładaniu nowej usługi należy podad następujące dane: Nazwa parametru Nazwa serwisu Opis Krótka nazwa określająca czego dotyczy serwis Fotogaleria użytkowników

17 Jest to ciąg znaków identyfikujący tworzoną usługę MMS. Jest to równocześnie treśd wiadomości MMS konieczna do tego, aby serwis Dotpay mógł zidentyfikowad poprawnie Identyfikator przesłaną wiadomośd MMS FOTOGALERIA Stawka Adres opisu usługi Adres URL skryptu Należy wybrad stawkę, dla której będzie aktywna usługa MMS. Szczegóły dotyczące wartości obsługiwanych wiadomości MMS znajdują się w pkt. 1. MMS o wartości 2zł netto przesłany na numer Jest to adres internetowy, pod którym znajduje się pełna informacja o usłudze MMS. Na stronie z usługą MMS należy podad wszystkie informacje jakie są wymagane w regulaminie usług MMS. W tym parametrze należy podad pełny adres do skryptu internetowego, który będzie odbierał wiadomośd MMS. Szczegóły i opis parametrów przesyłanych do skryptu znajduje się w pkt. 2.1 Parametr ten jest opcjonalny. W przypadku braku jego podania należy podad adres . Możliwe jest podanie równocześnie zarówno adresu do skryptu internetowego oraz adresu lub jednego z tych parametrów. 7 Adres Opis usługi Parametr opcjonalny, pozwala na odbiór wiadomości MMS poprzez wiadomośd . W przypadku braku podania wartości tego pola należy określid adres do skryptu odbierającego wiadomośd MMS. jan@nowak.pl Należy podad szczegółowy opis usługi, tj. na czym polega, do czego będą wykorzystane odebrane informacje. Usługa polega na przesłaniu obrazków z telefonu komórkowego i umieszczaniu na stronie mojego portalu internetowego 2.1. Odbiór parametrów przesyłanych do skryptu internetowego Za pomocą usługi przesyłania pełnej treści wiadomości MMS do skryptu internetowego użytkownik powinien móc odebrad zestaw parametrów opisany w poniższej tabeli: Nazwa parametru date service ident Opis Data wysłania MMSa przez użytkownika. Format daty jest następujący: RRRRMMDDggmmss date= Nazwa usługi MMS. Dla usługi wysyłania treści MMS do skryptu internetowego parametr service przyjmuje wartośd AP service=ap Identyfikator usługi MMS, dla którego przesłano wiadomośd MMS. Utworzono usługę MMS dla której należy w treści podad tekst: AP.FOTOGALERIA Dla takiej usługi parametr ident będzie miał następującą wartośd:

18 ident=fotogaleria number sender subject text textid textlocation code Numer na który przesłano wiadomośd MMS. Czyli jest to numer konektora, na którym odebrano wiadomośd MMS. number= Numer telefonu nadawcy wysyłającego wiadomośd MMS sender= Tytuł przesłanej wiadomości MMS subject=ulubiony dzwonek Pełna treśd MMSa text=ap.fotogaleria Numer ID obiektu tekstowego w wiadomości MMS textid=1 Umiejscowienie przesłanej treści w wiadomości MMS np. nazwa pliku textlocation=text.txt Parametr ten określa kod potwierdzający jaki otrzymuje użytkownik wysyłający wiadomośd MMS. Kod ten jest pomocny w późniejszej identyfikacji przesłanej wiadomości MMS. Za pomocą tego kodu można zrealizowad usługę dostępu do płatnej części serwisu lub stworzyd własne, nietypowe usługi. code=lses2pqx Parametr ten zawiera pełną treśd załączonego obiektu w wiadomości MMS. Format zapisu to ciąg zakodowany Base64. content=uklgrkkgaqbxqvzfzm10ibiaaaabaaeaqb8aaeafaaabaagaaab. 8 content contenttype contentid Uwaga! W przypadku wieloobiektowego MMSa każdy kolejny obiekt zawarty jest w kolejno numerowanych parametrach content według poniższego przykładu: content treśc pierwszego załączonego obiektu content1 treśd drugiego załączonego obiektu content2 treśd trzeciego załączonego obiektu content3 treśd czwartego załączonego obiektu itd. Określa typ wiadomości jaka jest przesłana w parametrze content Parametr ten jest zgodny z mime-type contenttype=audio/x-wav Uwaga! W przypadku wieloobiektowych wiadomości MMS dla każdego obiektu wskazany jest typ obiektu zgodnie z numeracją dla odpowiedniego parametru content. contenttype=audio/x-waw contenttype1=image/jpeg contenttype2=audio/mp3 Określa identyfikator załączonego obiektu w wiadomości MMS contentid=12 Uwaga!

19 W przypadku wieloobiektowej wiadomości MMS każdy kolejny obiekt identyfikowany jest w parametrze contentid. contentid=162 contentid1=2ac contentid2=b3 Nazwa przesłanego obiektu multimedialnego contentlocation=fajnydzwonek.wav 9 contentlocation Uwaga! W przypadku wieloobiektowej wiadomości MMS każdy kolejny obiekt zawiera nazwę przesyłanego obiektu w kolejno numerowanym parametrze contentlocation contentlocation=fajnydzwonej.wav contentlocation1=drugi_dzwonek.mp3 contentlocation2=tapeta.jpeg contentlocation3=animacja.gif Po przesłaniu zestawu parametrów do skryptu użytkownika serwis Dotpay oczekuje odpowiedzi w postaci jednego słowa OK bez żadnych dodatkowych znaków oraz bez znaków nowej linii. 3. MMS za SMS Zasada działania usługi MMS za SMS jest następująca: użytkownik wysyła zwykły SMS typu Premium o ustalonej wartości, a w zamian otrzymuje wiadomośd MMS Definiowanie usługi Aby skorzystad z tej usługi należy z menu usługi MMS wybrad Dodaj nową usługę MMS a następnie z listy wybrad: MMS zwrotny (MMS za SMS). Do utworzenia usługi należy podad następujące informacje: Nazwa pola Nazwa serwisu Identyfikator Stawka Opis Krótka nazwa określająca czego dotyczy serwis. Nazwa pozwala na łatwą identyfikację usługi. Zdjęcia z imprezy Jest to ciąg znaków identyfikujący tworzoną usługę MMS. Jest to równocześnie treśd wiadomości SMS jaką musi wpisad użytkownik aby otrzymad wiadomośd MMS. ZDJECIA Należy wybrad stawkę, dla której będzie aktywna usługa SMS. Szczegóły dotyczące wartości obsługiwanych wiadomości SMS znajdują się w pkt. 1. SMS o wartości 2zł netto przesłany na numer 72068

20 Jest to adres internetowy, pod którym znajduje się pełna informacja o usłudze SMS. Na stronie z usługą SMS należy podad wszystkie informacje jakie są wymagane w Adres opisu usługi regulaminie usług SMS i MMS. Adres URL skryptu Opis usługi W tym polu należy wprowadzid pełen adres do skryptu internetowego odbierającego zestaw parametrów opisujących wiadomośd SMS. Skrypt ten po przetworzeniu otrzymanych danych powinien odpowiedzied zestawem informacji potrzebnych do zbudowania wiadomości MMS Szczegóły i opis parametrów przesyłanych do skryptu znajduje się w pkt Jest to informacja dla pracowników serwisu opisująca na czym polega usługa, co klient otrzymuje za przesłanego SMSa, gdzie znajdują się szczegółowe informacje o usłudze, jakie należy użyd dane do logowania się pracownika Dotpay celem skontrolowania poprawności informacji o usłudze. Usługa polega na przesłaniu obrazków z telefonu komórkowego i umieszczaniu na stronie mojego portalu internetowego. Informacje na stronie dostępne są po podaniu hasła proszę wpisad: login: opis hasło: test Strona 20 Po utworzeniu usługi należy poczekad na jej aktywację przez serwis Dotpay. Gdy usługa zostanie zaakceptowana to użytkownik może wysład SMSa o treści MC.ZDJECIA na numer Premium SMS jaki zdefiniowano podczas zakładania usługi Pobieranie treści obiektów do wysyłki MMS Po otrzymaniu wiadomości SMS od użytkownika o odpowiedniej treści nastąpi przesłanie zestawu parametrów do skryptu wskazanego podczas zakładania usługi. Poniższa tabela zawiera informacje o przesyłanych parametrach: Nazwa parametru text ident Opis Pełna treśd wiadomości SMS od użytkownika. text=mc.ogloszenia Uwaga! Jeżeli w wiadomości SMS wskazano dodatkowo po kropce lub po spacji dalszą treśd to także zostanie przekazana do skryptu. Można tą funkcjonalnośd wykorzystad do określania dodatkowego parametru pozwalającego na rozbudowanie możliwości i funkcjonalności tej usługi. text=mc.ogloszenia.14 text=mc.tapety 88 text=mc.tapety GORY Identyfikator usługi

21 service number sender code date ident=ogloszenia Prefix usługi. Informacja o prefiksie przekazywana jest podczas tworzenia nowej usługi SMS. Dla usług MMS za SMS prefiksem jest stała wartośd MC service=mc Numer konektora na jaki wysłano wiadomośd SMS Premium. Obecnie dostępne są następujące numery: 71068, 72068, 73068, 75068, Druga cyfra w numerze konektora określa wartośd netto za przesłaną wiadomośd SMS number=72068 Numer telefonu komórkowego z jakiego przesłano wiadomośd SMS. Format zapisu numeru jest postaci: 48xxxxxxxxx Przykład sender= Po każdej przesłanej wiadomości SMS nadawca otrzymuje SMSa zwrotnego z kodem potwierdzającym. Kod ten generowany jest losowo i jest niepowtarzalny. Można go wykorzystad dodatkowo jako kod dostępu do serwisu. Code=KCNA723C Data przesłania wiadomości SMS. Format zapisu jest następujący: RRRRMMDDggmmss Gdzie: R rok g godzina M miesiąc m minuta D dzieo s sekunda Strona 21 date= Po przesłaniu powyższego zestawu parametrów do skryptu użytkownika serwis Dotpay oczekuje odpowiedzi zawierającej pełną treśd wiadomości MMS w kolejnych wierszach zgodnie z poniższą tabelą. Każdy wiersz tabeli to kolejny wiersz odpowiedzi. Poniżej tabeli przedstawiono kompletny przykład. Bardzo ważnym elementem odpowiedzi jest słowo OK które musi znaleźd się jako pierwsza informacja odsyłana przez skrypt przetwarzający odbiór wiadomości SMS. Nazwa parametru OK Text Opis Potwierdzenie poprawnego odbioru zestawu parametrów opisujących wiadomośd SMS przesłaną od nadawcy. To nie jest parametr, tylko komunikat odpowiedzi. Parametr określający treśd wiadomości tekstowej MMS

22 text=to jest wiadomośd tekstowa zwrotna. Typ przesyłanej wiadomości tekstowej. Dla zwykłego tekstu należy podad: text/plan texttype textlocation textid content texttype=text/plan Nazwa pliku tekstowego zawierająca przesyłaną wiadomośd tekstową. textlocation=komunikat.txt Identyfikator elementu tekstowego. Parametr ten nie jest obowiązkowy. textid=a12 Zakodowana w BASE64 treśd pliku, który ma zostad dołączony jako obiekt. content=uklgrkkgaqbxqvzfzm10ibiaaaabaaeaqb8aaeafaaabaagaaabkyxr. Typ pliku zawartego w parametrze content. Wartośd tego parametru jest zgodna z mimetype Strona 22 contenttype Najczęściej spotykane elementy danych: - application/smil (.smi) -opis sposobu prezentacji wiadomosci - image/jpeg - obrazek JPG - (.jpg,.jpeg) - image/gif - obrazek GIF (również animowany) - (.gif) - audio/amr - dźwięk AMR - (.amr) - audio/mp3 - dźwięk MP3 - (.mp3) contentlocation contentid contenttype=audio/x-wav Nazwa dołączanego pliku z parametru content. contentlocation=dzwonek.wav Identyfikator dołączanego obiektu. Parametr ten nie jest obowiązkowy contentid=a12 Jeżeli odsyłany MMS ma zawierad równocześnie kilka obiektów to należy powtórzyd parametry rozpoczynające się od słowa content dodając kolejny numer do parametru. Poniżej zamieszczono przykład odpowiedzi skryptu przedstawiającego treści do wysłania jako wieloobiektowego MMSa zawierającego jedną wiadomośd tekstową: OK text=jakas Tekst MMSa zwrotnego. texttype=text/plain

23 textlocation=text.txt textid=1 content=usjdnfksjdfnsfsifsdnfioamcaoscuiwnwciancakscoas... contenttype=image/jpeg contentlocation=fotka.jpg contentid=5 content1=msdfi22nnsdcoaomasommsdovvimsoeoslsla/sananaiia... contenttype1=image/jpeg contentlocation1=fotka_15.jpg contentid1=8 content2=msdfi22nnsdcoaomasommsdovvimsoeoslsla/sananaiia... contenttype2=audio/x-wav contentlocation2=beep.wav contentid2=9 Strona 23 Należy zwrócid szczególną uwagę na to, aby skrypt odpowiedział słowem OK co zaprezentowano w powyższym przykładzie. Wszystkie wartości parametrów powinny byd zgodne z formatem kodowania URL. Sumarycznie wielkośd plików w tak przygotowanej wiadomości MMS nie może przekroczyd 100kB. Poniżej zamieszczono pełen przykład skryptu w języku PHP realizującego przesłanie wiadomości MMS po otrzymaniu wiadomości SMS o treści MC.TEST. Poniższy skrypt jest przykładem pliku mms.php który został podany podczas tworzenia usługi w punkcie 3.1 jako wskazany skrypt w Adresie URL. <?php // Autor: Dotpay.pl // // skrypt generujący przykladowego MMSa zawierającego tresc, temat // oraz dwa elementy danych (pliki obrazów) // skrypt odpowiada na SMSa o treści MC.TEST generując MMSa if ( strtoupper($_post['text']) == 'MC.TEST') { // przygotowanie MMSa zwrotnego // // tresc $mms['text'] = "To jest tresc MMSa zwrotnego."; $mms['texttype'] = "text/plain"; $mms['textlocation'] = "text.txt";

24 $mms['textid'] = 0; // pliki $content_plik = 'fotka.jpg'; $mms['contenttype'] = 'image/jpeg'; $mms['contentlocation'] = $content_plik; $mms['contentid'] = 0; Strona 24 $content_plik1 = 'fotka1.jpg'; $mms['contenttype1'] = 'image/jpeg'; $mms['contentlocation1'] = $content_plik1; $mms['contentid1'] = 1; // temat MMSa $mms['subject'] = "To jest temat MMSa zwrotnego."; // kodowanie plików $uchwyt_plik = fopen($content_plik,'rb'); $mms['content'] = base64_encode( fread($uchwyt_plik, filesize($content_plik)) ); $uchwyt_plik1 = fopen($content_plik1,'rb'); $mms['content1'] = base64_encode( fread($uchwyt_plik1, filesize($content_plik1)) ); // wydruk do pliku odpowiedzi print "OK\n"; foreach( $mms as $klucz => $wartosc ) { print $klucz."=".urlencode($wartosc)."\n"; } }?> 4. Informacje dodatkowe Adres IP serwera Dotpay to: lub Z tych adresów wywoływane są skrypty kontrahentów, dla których nastąpiło przesłanie wiadomości SMS, MMS lub inna forma powiadomienia. III. DOŁADOWANIA TELEFONÓW KOMÓRKOWYCH Serwis Dotpay udostępnia swoim użytkownikom możliwośd doładowania telefonów komórkowych typu prepaid (na kartę) za pośrednictwem wszystkich dostępnych kanałów płatności. Doładowanie

25 telefonu zgodnie z obowiązującym regulaminem oraz dostępnymi okresowo promocjami możliwe jest po skorzystaniu z poniższej strony internetowej: Serwis Dotpay umożliwia również, aby użytkownicy serwisu Dotpay (czyli użytkownicy zarejestrowani w serwisie Dotpay posiadający ważny numer ID) otrzymywali dodatkowe wynagrodzenie z każdego doładowania, które zostało polecone użytkownikowi telefonu. Wystarczy, że użytkownik telefonu wejdzie na adres serwisu Dotpay podając po znaku ukośnika (slash) numer ID użytkownika serwisu Dotpay. Przejście to może byd zrealizowane za pomocą linku ze strony WWW lub z wiadomości wysłanej do użytkownika telefonu. Strona 25 Poniżej zamieszczono przykład linku, z którego należy skorzystad, aby użytkownik serwisu Dotpay o numerze ID otrzymał dodatkowo wynagrodzenie z każdego doładowania telefonu komórkowego: Aktualne stawki wynagrodzeo z każdego doładowania telefonu znajdują się w regulaminie doładowao dostępnego w menu Regulamin dostępnego na głównej stronie internetowej serwisu Dotpay. Odwołanie do strony serwisu pozwalającego na doładowanie możliwe jest po skorzystaniu z jednego z poniższych linków: IV. USŁUGA PAY PER CALL Usługa Pay Per Call pozwala na sprzedaż kodów dostępowych do serwisów i systemów za pośrednictwem telefonu stacjonarnego lub komórkowego. Osoba, która chce skorzystad z płatnej części serwisu internetowego musi zadzwonid pod specjalny numer xxx-xxx, gdzie po podaniu czterocyfrowego numeru usłyszy kod dostępu.

26 Tworzenie usługi płatnego dostępu Pay Per Call: Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC 1) w panelu dotpay należy : a) z menu - usługi SMS/MMS wybrad podmenu - usługi pay per call b) kolejno - dodaj nową usługę Strona 26 2) następnie należy podad zestaw informacji określających tworzoną usługę: a) nazwa usługi b) wartośd usługi zgodnie z tabelą 1. c) adres URL do strony, gdzie znajduje się zamieszczona informacja o usłudze d) krótki opis usługi ( gdzie jest wykorzystywana i co użytkownik uzyskuje po wprowadzeniu otrzymanego kodu dostępu) e) określenie wielkości listy z kodami, od szt. kodów 3) zaakceptowad wprowadzone dane i tym samym utworzyd usługę Po utworzeniu usługi Pay Per Call użytkownik serwisu Dotpay zobaczy potwierdzenie utworzenia usługi oraz informacje na jaki numer telefonu klient powinien zadzwonid i jaki kod usługi został przydzielony. Usługa Pay per Call została utworzona Aby skorzystad z usługi klient powinien zadzwonid na numer: Po usłyszeniu odpowiedniego komunikatu należy wprowadzid czterocyfrowy numer usługi: 6905 Po wprowadzeniu czterocyfrowego kodu klient usłyszy zakupiony kod. Wiadomośd odtwarzana jest 3 razy. Zgodnie z powyższym przykładem, klient aby otrzymad kod dostępu powinien zadzwonid pod numer podając jako numer usługi czterocyfrowy kod: Po wprowadzeniu czterocyfrowego kodu, klient trzykrotnie usłyszy wydany mu kod. Kody wydawane są kolejno z listy wygenerowanych kodów.

27 Uwaga! Każda utworzona usługa musi zostad aktywowana. Aktywacja przez operatora serwisu następuje w ciągu 24.godzin. Po aktywowaniu usługi zostanie przesłany potwierdzający włączenie usługi. Bieżący status usługi można sprawdzid korzystając z menu listy usług Pay Per Call. Strona 27 Tabela 1. Wartości usług Pay Per Call dla każdego z numerów dostępowych Numer telefonu Wartośd netto Wartośd brutto zł 1.42 zł zł 6.37 zł zł zł