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]

Podobne dokumenty