27
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] I. Usługi Premium SMS II. Usługi Premium MMS III. Doładowania IV. Pay Per Call INSTRUKCJA TECHNICZNA USŁUG PREMIUM SMS I MMS DOŁADOWAŃ I PAY PER CALL

INSTRUKCJA TECHNICZNA USŁUG PREMIUM SMS I MMS …winiu.com/support/dotpay/dotpay_instrukcja_techniczna_uslug... · Proponowanym rozwiązaniem jest zastosowanie bazy danych (np. MySQL)

  • Upload
    ngocong

  • View
    222

  • Download
    0

Embed Size (px)

Citation preview

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]

I. Usługi Premium SMS

II. Usługi Premium MMS

III. Doładowania

IV. Pay Per Call

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

_________________________________________________________________________________

_________________________________________________________________________________________________________

Dział Pomocy Technicznej: ul. Wielicka 72, 30-552 Kraków, Tel. 012 688 26 00, email: [email protected]

Strona | 1 Strona | 2

Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008)

SPIS TREŚCI

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. Odbiór parametrów przesyłanych do skryptu internetowego .............................17

3. MMS za SMS ..............................................................................................................19

3.1. Definiowanie usługi ............................................................................................19

3.2. Pobieranie treści obiektów do wysyłki MMS .......................................................20

4. 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]

Strona | 1 Strona | 3

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).

1. Informacje podstawowe

Serwis Dotpay.pl udostępnia swoim klientom możliwośd obsługiwania wiadomości SMS odbieranych

na następujących numerach dostępowych (konektorach):

Konektor Wartośd netto za 1 wiadomośd SMS

70068 0.50 zł

71068 1.00 zł

72068 2.00 zł

73068 3.00 zł

75068 5.00 zł

76068 6.00 zł

79068 9.00 zł

66866 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]

Strona | 1 Strona | 4

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

(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]

Strona | 1 Strona | 5

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:

- 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]

Strona | 1 Strona | 6

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.

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]

Strona | 1 Strona | 7

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”;

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]

Strona | 1 Strona | 8

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.

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]

Strona | 1 Strona | 9

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

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]

Strona | 1 Strona | 10

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”; 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]

Strona | 1 Strona | 11

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

się informacja o usłudze SMS, jak również należy podad pełen opis na czym polega wykorzystanie

usługi.

Aby dokonad zdefiniowania nowych 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]

Strona | 1 Strona | 12

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

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ł 71068 2

2zł 72068 2

3zł 73068 5

5zł 75068 14

6zł 76068 14

9zł 79068 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]

Strona | 1 Strona | 13

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,

8. należy podad krótki opis utworzonej usługi, do czego służy, jak i gdzie odszukad

informacje na stronie kontrahenta,

9. po skorzystaniu z guzika „Utwórz usługę” następuje przejście do konfiguracji usługi.

W ten sposób utworzono przykładową usługę, w której klient powinien wysład SMSa o treści

NJ.OGLOSZENIA na numer 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]

Strona | 1 Strona | 14

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!

Każda zmiana treści lub wprowadzenie nowej treści ma skutek natychmiastowy. Jeśli wiadomośd o

treści XXXXX miała zostad wysłana do nadawcy, a została zmieniona przez właściciela usługi przed

wysłaniem na treśd YYYY to gdy nadejdzie czas wysyłki to zostanie odesłana wiadomośd po zmianie,

czyli YYYY.

Konfiguracja zaawansowana

Możliwe jest wprowadzenie zmiennego terminu wysyłanej wiadomości dla każdej określonej treści.

Zatem pomimo określenia jednego globalnego terminu wysyłek, możliwe jest wprowadzenie

terminów dla każdej treści z osobna. Aby tego dokonad należy wprowadzid numer usługi oraz literę

określająca termin wysłania treści zgodnie z oznaczeniem z tabeli.

Terminy przedstawione są w poniższej tabeli:

Litera Termin

A 1:00 - 6:00

B 6:00 - 9:00

C 9:00 - 12:00

D 12:00 - 16:00

E 16:00 - 19:00

F 19:00 - 22:00

G 22:00 - 01:00

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]

Strona | 1 Strona | 15

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.

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]

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)

Serwis Dotpay udostępnia swoim klientom możliwośd obsługiwania wiadomości MMS odbieranych

na następujących numerach dostępowych (konektorach):

Konektor Wartośd netto za 1 wiadomośd MMS

902123 2.00 zł

909123 9.00 zł

Odbiór wiadomości SMS udostępniony jest na następujących numerach dostępowych (konektorach):

Konektor Wartośd netto za 1 wiadomośd MMS

71068 1.00 zł

72068 2.00 zł

73068 3.00 zł

75068 5.00 zł

76068 6.00 zł

79068 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 Opis

Nazwa serwisu 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 | 17

Instrukcja techniczna usług Premium SMS, MMS, Doładowań i PPC (Tekst jednolity wersji 0.2 z dnia 29 kwiatnia 2008)

Identyfikator

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

Stawka

Należy wybrad stawkę, dla której będzie aktywna usługa MMS. Szczegóły dotyczące

wartości obsługiwanych wiadomości MMS znajdują się w pkt. 1.

Przykład: MMS o wartości 2zł netto przesłany na numer 902123

Adres opisu usługi

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

Adres URL skryptu

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

Adres email

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]

Opis usługi

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

2.1. Odbiór parametrów przesyłanych do skryptu internetowego

Za pomocą usługi przesyłania pełnej treści wiadomości MMS do skryptu internetowego użytkownik

powinien móc odebrad zestaw parametrów opisany w poniższej tabeli:

Nazwa parametru Opis

date

Data wysłania MMSa przez użytkownika. Format daty jest następujący:

RRRRMMDDggmmss

Przykład: date=20060720145233

service

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

ident

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]

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)

ident=FOTOGALERIA

number

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

sender Numer telefonu nadawcy wysyłającego wiadomośd MMS

Przykład: sender=48602000123

subject Tytuł przesłanej wiadomości MMS

Przykład: subject=ulubiony dzwonek

text Pełna treśd MMSa

Przykład: text=AP.fotogaleria

textId Numer ID obiektu tekstowego w wiadomości MMS

Przykład: textId=1

textLocation Umiejscowienie przesłanej treści w wiadomości MMS np. nazwa pliku

Przykład: textLocation=text.txt

code

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

content

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.

contentType

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

contentId

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 | 19

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

contentId2=B3

contentLocation

Nazwa przesłanego obiektu multimedialnego

Przykład: contentLocation=fajnydzwonek.wav

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 Opis

Nazwa serwisu

Krótka nazwa określająca czego dotyczy serwis. Nazwa pozwala na łatwą identyfikację

usługi.

Przykład: „Zdjęcia z imprezy”

Identyfikator

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

Stawka

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]

Strona | 1 Strona | 20

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

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

Adres URL skryptu

W tym polu należy wprowadzid pełen adres do skryptu internetowego odbierającego

zestaw parametrów opisujących wiadomośd SMS. Skrypt ten po przetworzeniu

otrzymanych danych powinien odpowiedzied zestawem informacji potrzebnych do

zbudowania wiadomości MMS

Szczegóły i opis parametrów przesyłanych do skryptu znajduje się w pkt. 3.2

Przykład: http://www.fotogaleria.pl/mms.php

Opis usługi

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 Opis

text

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

ident Identyfikator usługi

_________________________________________________________________________________

_________________________________________________________________________________________________________

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:

ident=OGLOSZENIA

service

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

Przykład:

service=MC

number

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

sender

Numer telefonu komórkowego z jakiego przesłano wiadomośd SMS. Format zapisu

numeru jest postaci: 48xxxxxxxxx

Przykład

sender=48602666123

code

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

date

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 Opis

OK Potwierdzenie poprawnego odbioru zestawu parametrów opisujących wiadomośd SMS

przesłaną od nadawcy. To nie jest parametr, tylko komunikat odpowiedzi.

Text 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 | 22

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.

textType

Typ przesyłanej wiadomości tekstowej. Dla zwykłego tekstu należy podad: text/plan

Przykład:

textType=text/plan

textLocation

Nazwa pliku tekstowego zawierająca przesyłaną wiadomośd tekstową.

Przykład:

textLocation=komunikat.txt

textId

Identyfikator elementu tekstowego. Parametr ten nie jest obowiązkowy.

Przykład:

textId=A12

content

Zakodowana w BASE64 treśd pliku, który ma zostad dołączony jako obiekt.

Przykład:

content=UklGRkKGAQBXQVZFZm10IBIAAAABAAEAQB8AAEAfAAABAAgAAABkYXR….

contentType

Typ pliku zawartego w parametrze content. Wartośd tego parametru jest zgodna z mime-

type

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

contentLocation

Nazwa dołączanego pliku z parametru content.

Przykład:

contentLocation=dzwonek.wav

contentId

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 | 23

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 | 24

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 | 25

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/

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]

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)

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 | 27

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.

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ł