instrukcja techniczna usług premium sms i mms doładowań i pay
Transkrypt
instrukcja techniczna usług premium sms i mms doładowań i pay
Biuro Obsługi Klienta Dotpay ul. Wielicka 72, 30-552 Kraków tel.: +48 12 688 26 00 faks: +48 12 688 26 99 email: [email protected] INSTRUKCJA TECHNICZNA USŁUG PREMIUM SMS I MMS DOŁADOWAŃ I PAY PER CALL I. II. III. IV. Usługi Premium SMS Usługi Premium MMS Doładowania Pay Per Call Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ SPIS TREŚCI Strona | 1 Strona | 2 I. USŁUGI PREMIUM SMS ................................................................................................3 1. Informacje podstawowe ..............................................................................................3 2. Kody dostępu ...............................................................................................................3 2.1. Generowanie listy 8-mio znakowych kodów .........................................................4 2.2. Kod generowany i dopisywany do listy kodów. Sprawdzanie kodów .....................4 3. Treśd zwrotna ..............................................................................................................7 4. Treści przesyłane na wskazany adres email lub do skryptu ...........................................9 5. SMS typu Wappush ....................................................................................................10 6. Infoserwisy ................................................................................................................12 7. Informacje dodatkowe ...............................................................................................14 II. USŁUGI PREMIUM MMS.............................................................................................15 1. Informacje podstawowe ............................................................................................15 2. Przesyłanie treści MMS do skryptu lub na wskazany adres e-mail ..............................16 2.1. 3. 4. Odbiór parametrów przesyłanych do skryptu internetowego .............................17 MMS za SMS ..............................................................................................................19 3.1. Definiowanie usługi ............................................................................................19 3.2. Pobieranie treści obiektów do wysyłki MMS .......................................................20 Informacje dodatkowe ...............................................................................................24 III. DOŁADOWANIA TELEFONÓW KOMÓRKOWYCH ........................................................24 IV. USŁUGA PAY PER CALL ...............................................................................................25 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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 | 1 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 70068 71068 72068 73068 75068 76068 79068 66866 Wartośd netto za 1 wiadomośd SMS 0.50 zł 1.00 zł 2.00 zł 3.00 zł 5.00 zł 6.00 zł 9.00 zł 1.99 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: _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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 Strona Strona||14 (np. 1000 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ę. 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. 2.2. 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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: Strona | 1 Strona | 5 - 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). 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) 217.29.42.39 - w tym przypadku informacje o ważności kodu będą udostępniane jedynie serwerowi zgłaszającemu się z tego numeru IP 2) 217.29.42.29,217.29.42.28 – w tym przypadku informacje będą zwracane dla serwera zgłaszającego się z jednego z 2 wyżej wymienionych adresów IP 3) 217.29.* - kod będzie sprawdzany dla serwera identyfikującego się przynajmniej tymi dwoma numerami sieci. Jest to równoważny zapis dla adresu: 217.29.*.* 4) 217.29.42.30, 217.55.78.* - akceptowane będą zapytania z określonego adresu IP oraz z całej puli adresów sieci 217.55.78.* 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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. Strona | 1 Strona | 6 Przykład: 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 72068 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. 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: _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ $id=99; $code=”ARCH”; $type=”sms”; $page=”strona2.php”; Strona | 1 Strona | 7 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”; ?> 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ę. _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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. Strona | 1 Strona | 8 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!) 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 www.onet.pl 2=Sprzedam uzywany spadochron. 3=Kontakt do Joli to +48 500 234 567 email [email protected] Prawidłowe skorzystanie z usługi będzie miało miejsce, gdy klient wyśle SMSa na numer 75068 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 4. Treści przesyłane na wskazany adres email 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 email w postaci wiadomości Strona | 1 Strona | 9 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. 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 email podany podczas rejestracji, b) czy treśd SMSa ma byd przekazana na adres email 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ $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”; Strona | 1 Strona | 10 exit; ?> 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. 48 22 391 2103 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), _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ - 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 Strona | 1 się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie Strona | 11 usługi. 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=http://wap.costam.pl/zapomnial.mid 1=Strzelanka=http://wap.gry.pl/strzelaj.jad 2=Robocik=http://wap.mobilegames.pl/gierka.jad Prawidłowe skorzystanie z usługi będzie miało miejsce, gdy klient wyśle SMSa na numer 79068 o treści: RS.GRY.2 Dla tak otrzymanego SMSa nadawca otrzyma po chwili zakładkę WAP o nazwie „Robocik” zawierającą link http://wap.mobilegames.pl/gierka.jad 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ą _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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=http://www.mobilegames.pl/puzzle.jad Strona | 1 Strona | 12 6. 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 Ilośd wysyłanych wiadomości SMS 1zł 2zł 3zł 5zł 6zł 9zł 71068 72068 73068 75068 76068 79068 2 2 5 14 14 30 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. Przykład: wybrano stawkę za 2zł, czyli 2 treści będą wysłane do nadawcy wiadomości SMS _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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, Strona | 1 8. należy podad krótki opis utworzonej usługi, do czego służy, jak i gdzie odszukad Strona | 13 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 72068. W zamian otrzyma 2 treści zwrotne. 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. Przykład: _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Usuwamy treśd zapisaną pod numerem 3: 3= UWAGA! Strona | 1 Każda zmiana treści lub wprowadzenie nowej treści ma skutek natychmiastowy. Jeśli wiadomośd o Strona | 14 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. 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 A B C D E F G Termin 1:00 - 6:00 6:00 - 9:00 9:00 - 12:00 12:00 - 16:00 16:00 - 19:00 19:00 - 22:00 22:00 - 01:00 Przykład: 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Adres IP serwera Dotpay to: 217.17.41.5 lub 195.150.9.37. 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. Strona | 1 Strona | 15 II. USŁUGI PREMIUM MMS 1. Informacje podstawowe _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Serwis Dotpay udostępnia swoim klientom możliwośd obsługiwania wiadomości MMS odbieranych na następujących numerach dostępowych (konektorach): Konektor 902123 Wartośd netto za 1 wiadomośd MMS 2.00 zł 909123 9.00 zł Odbiór wiadomości SMS udostępniony jest na następujących numerach dostępowych (konektorach): Konektor 71068 72068 73068 Wartośd netto za 1 wiadomośd MMS 1.00 zł 2.00 zł 3.00 zł 75068 76068 79068 5.00 zł 6.00 zł 9.00 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 e-mail 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 e-mail 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 email” 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 Przykład: „Fotogaleria użytkowników” _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 16 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Identyfikator Stawka Adres opisu usługi Adres URL skryptu Adres email Opis usługi 2.1. 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 przesłaną wiadomośd MMS Przykład: FOTOGALERIA Należy wybrad stawkę, dla której będzie aktywna usługa MMS. Szczegóły dotyczące Strona | 1 Strona | 17 wartości obsługiwanych wiadomości MMS znajdują się w pkt. 1. Przykład: MMS o wartości 2zł netto przesłany na numer 902123 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. Przykład: http://www.fotogaleria.pl/wyslij_mms.html 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 email. Możliwe jest podanie równocześnie zarówno adresu do skryptu internetowego oraz adresu email lub jednego z tych parametrów. Przykład: http://www.fotogaleria.pl/odbierz_mms.php Parametr opcjonalny, pozwala na odbiór wiadomości MMS poprzez wiadomośd email. W przypadku braku podania wartości tego pola należy określid adres do skryptu odbierającego wiadomośd MMS. Przykład: [email protected] Należy podad szczegółowy opis usługi, tj. na czym polega, do czego będą wykorzystane odebrane informacje. Przykład: Usługa polega na przesłaniu obrazków z telefonu komórkowego i umieszczaniu na stronie mojego portalu internetowego 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 Przykład: date=20060720145233 Nazwa usługi MMS. Dla usługi wysyłania treści MMS do skryptu internetowego parametr service przyjmuje wartośd AP Przykład: service=AP Identyfikator usługi MMS, dla którego przesłano wiadomośd MMS. Przykład: 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: _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ number sender subject text textId textLocation code content contentType contentId ident=FOTOGALERIA Numer na który przesłano wiadomośd MMS. Czyli jest to numer konektora, na którym odebrano wiadomośd MMS. Przykład: number=902123 Numer telefonu nadawcy wysyłającego wiadomośd MMS Przykład: sender=48602000123 Tytuł przesłanej wiadomości MMS Przykład: subject=ulubiony dzwonek Pełna treśd MMSa Przykład: text=AP.fotogaleria Numer ID obiektu tekstowego w wiadomości MMS Przykład: textId=1 Umiejscowienie przesłanej treści w wiadomości MMS np. nazwa pliku Przykład: 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. Przykład: code=LSES2PQX Parametr ten zawiera pełną treśd załączonego obiektu w wiadomości MMS. Format zapisu to ciąg zakodowany Base64. Przykład: content=UklGRkKGAQBXQVZFZm10IBIAAAABAAEAQB8AAEAfAAABAAgAAAB…. 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 Przykład: 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. Przykład: contentType=audio/x-waw contentType1=image/jpeg contentType2=audio/mp3 Określa identyfikator załączonego obiektu w wiadomości MMS Przykład: contentId=12 Uwaga! _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 18 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ W przypadku wieloobiektowej wiadomości MMS każdy kolejny obiekt identyfikowany jest w parametrze contentId. Przykład: contentId=162 contentId1=2AC Strona | 1 Strona | 19 contentId2=B3 Nazwa przesłanego obiektu multimedialnego Przykład: contentLocation=fajnydzwonek.wav contentLocation Uwaga! W przypadku wieloobiektowej wiadomości MMS każdy kolejny obiekt zawiera nazwę przesyłanego obiektu w kolejno numerowanym parametrze contentLocation Przykład: 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. 3.1. 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. Przykład: „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. Przykład: 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. Przykład: SMS o wartości 2zł netto przesłany na numer 72068 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Adres opisu usługi Adres URL skryptu Opis usługi 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 regulaminie usług SMS i MMS. Przykład: http://www.fotogaleria.pl/opis_mms.html W tym polu należy wprowadzid pełen adres do skryptu internetowego odbierającego Strona Strona||120 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. 3.2 Przykład: http://www.fotogaleria.pl/mms.php 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. Przykład: 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 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. 3.2. 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. Przykład: 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. Przykład: text=MC.OGLOSZENIA.14 text=MC.TAPETY 88 text=MC.TAPETY GORY Identyfikator usługi _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Przykład: 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 number Przykład: service=MC Numer konektora na jaki wysłano wiadomośd SMS Premium. Obecnie dostępne są następujące numery: 71068, 72068, 73068, 75068, 79068 Druga cyfra w numerze konektora określa wartośd netto za przesłaną wiadomośd SMS Przykład: number=72068 Numer telefonu komórkowego z jakiego przesłano wiadomośd SMS. Format zapisu numeru jest postaci: 48xxxxxxxxx sender code date Przykład sender=48602666123 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. Przykład: 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 Przykład: date=20060905145126 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 21 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Przykład: 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 contentType Przykład: textType=text/plan Nazwa pliku tekstowego zawierająca przesyłaną wiadomośd tekstową. Przykład: textLocation=komunikat.txt Identyfikator elementu tekstowego. Parametr ten nie jest obowiązkowy. Przykład: textId=A12 Zakodowana w BASE64 treśd pliku, który ma zostad dołączony jako obiekt. Przykład: content=UklGRkKGAQBXQVZFZm10IBIAAAABAAEAQB8AAEAfAAABAAgAAABkYXR…. Typ pliku zawartego w parametrze content. Wartośd tego parametru jest zgodna z mimetype 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) Przykład: contentType=audio/x-wav Nazwa dołączanego pliku z parametru content. contentLocation contentId Przykład: contentLocation=dzwonek.wav Identyfikator dołączanego obiektu. Parametr ten nie jest obowiązkowy Przykład: 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 22 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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 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 // http://www.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"; _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 23 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ $mms['textId'] = 0; // pliki $content_plik = 'fotka.jpg'; $mms['contentType'] = 'image/jpeg'; $mms['contentLocation'] = $content_plik; $mms['contentId'] = 0; $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: 217.17.41.5 lub 195.150.9.37. 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 _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 24 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ telefonu zgodnie z obowiązującym regulaminem oraz dostępnymi okresowo promocjami możliwe jest po skorzystaniu z poniższej strony internetowej: http://gsm.dotpay.pl/ Strona | 1 Strona | 25 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 http://gsm.dotpay.pl/ 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 email wysłanej do użytkownika telefonu. Poniżej zamieszczono przykład linku, z którego należy skorzystad, aby użytkownik serwisu Dotpay o numerze ID 12345 otrzymał dodatkowo wynagrodzenie z każdego doładowania telefonu komórkowego: http://gsm.dotpay.pl/12345 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: 1. http://doladowania.dotpay.pl 2. http://gsm.dotpay.pl 3. http://prepaid.dotpay.pl 4. http://topup.dotpay.pl. 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 0-400-xxx-xxx, gdzie po podaniu czterocyfrowego numeru usłyszy kod dostępu. _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ Tworzenie usługi płatnego dostępu Pay Per Call: 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ę 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 250-5000 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. Przykład: Usługa Pay per Call została utworzona Aby skorzystad z usługi klient powinien zadzwonid na numer: 0-400-107-107 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 0-400-107-107 podając jako numer usługi czterocyfrowy kod: 6905. Po wprowadzeniu czterocyfrowego kodu, klient trzykrotnie usłyszy wydany mu kod. Kody wydawane są kolejno z listy wygenerowanych kodów. _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected] Strona | 1 Strona | 26 Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008) _________________________________________________________________________________ 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 email 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 | 1 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 0-400-107-107 1.16 zł 1.42 zł 0-400-507-507 5.22 zł 6.37 zł 0-400-707-707 10.15 zł 12.38 zł _________________________________________________________________________________________________________ Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected]