Protocolul de comunicatie pentru tranzactiile de microplati prin SMS

I. Introducere

........................................................................................... 3

II. Orange.................................................................................................................... 4 III. Vodafone............................................................................................................... 7 IV. Cosmote.............................................................................................................. 11 ............................................................................................................................ 14 V. Antifrauda........................................................................................................... 1 VI. !rori..................................................................................................................... 1"

10 Aprilie 13

I.

Introducere

Prezentul document isi propune descrierea serviciului de microplati prin SMS functional in urmatoarele retele: Orange, Vodafone si Cosmote. In continuare se va descrie mecanismul de functionare si realizare al comenzilor pentru fiecare retea in parte in functie de modalitatea de taxare: mo_ illing ! mt_ illing. Sc"ema generala de functionare este urmatoarea:
Client Operato r Mediasa t Partene r

#axarea clientului se face pe M# in cazul Orange si Vodafone $MTBilling% si pe MO in cazul Cosmote $MOBilling%.

&eoarece Cosmote este de tip MOBilling, si in final functionarea acestuia este diferita, este necesar ca parametrii transmisi sa nu fie tratati 'case sensitive(.

II.

Orange Mecanism de functionare

Clientul trimite un sms de comanda catre un numar scurt $de ex )*)+% pentru care primeste un mesa, de informare de la acelasi numar scurt $)*)+% la care tre uie sa confirme prin textul &a, si in functie de creditul disponi il va realiza sau nu o tranzactie valida primind mesa,ul corespunzator de la acelasi numar scurt de pe care s-a inregistrat $)*)+%. MediaSat intermediaza comunicatia intre partener si operator pentru clientul respectiv.

Schema de functionare

Comunicatia si transmiterea mesa,elor se realizeaza in . pasi prin metoda /##P POS# re0uest catre partener avand urmatorii parametri:
Parametru msgdate te*t re+,-alidated Semnificatie data mesa$ului trimis de catre client% in format &&&&'mm'dd (()mm)ss continutul mesa$ului trimis de catre client statusul de procesare al comenzii% acesta poate lua una din urmatoarele -alori) 1 . cerere ser-iciu din partea clientului / pentru la'urile in s(aring% 0e&1ord'ul de comanda este sta2ilit si configurat3 # . confirmarea ser-iciului de catre client prin trimiterea te*tului 45a6 3 ' confirmarea platii de catre realizandu'se o comanda -alida operator% Pasi 1%#%3 1%#%3 1%#%3

O2s) in cazul in care se primeste eroare de ta*are de la operator /clientul n'are suficient credit3 sau sunt pro2leme la transmiterea mesa$elor% acest status -a fi raportat in etapa de 5eli-er& 4 . !roare de ta*are . Clientul a anulat ser-iciul% prin comanda 4stop6 " . 7ranzactie e*pirata 7 . 7ranzactie anulata /comanda noua3 netalias transaction,id p(onenum2er s(ortnum2er ans1,message orders,left pa&,la servicenumber 8 . 9imita comenzi atinsa O:; % reteaua clientului. id'ul tranzactiei. <nic per tranzactie=operator. numarul de telefon al clientului large account'ul ser-iciului. Poate fi un alias. mesa$ul de raspuns pe care'l -a primi clientul in urma mesa$ului de comanda numarul de comenzi ramase in luna curenta large account'ul de pe care se face ta*area este acelasi la care clientul se inregistreaza Numarul scurt real folosit de catre clientii finali. Optional. 1%#%3 1%#%3 1%#%3 1%#%3 1 # 3 1%#%3

:aspunsul la post poate fi)

Raspuns POST O>? O>?te*t message

Semnificatie transmisia si receptia mesa$ului a a-ut loc fara erori transmisia si receptia mesa$ului a a-ut loc fara erori% clientul primind mesa$ul dorit si sta2ilit de catre partener% ex: un cod pe baza caruia clientul se va putea inregistra ulterior sunt pro2leme de comunicatie si ser-iciul nu este functional% clientul fiind instiintat de acest lucru

!::?te*t message

Exemple: Pasul 1 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@ ans1,messageAaiBcomandatBpromo-areBanuntB.ro. BpentruBconfirmareBtrimiteBdaBlaB747"/costBtotalB".1CBeurD#2t-a3 D#cptBrenuntareBtrimiteBstopBlaB747".Binfo D3aBC314C 334EmsgdateA#C13'C4'C#B1"D3a13D3a3FEte*tA>!GHO:5 D#C"3"8 18FEnetACEtransaction,idA8#CCCCEp(onenum2erAC7CCCCCCCCEre+,alidatedA1Es(ortnum2erA747"Eser-icenum2erA747"EnetaliasAO:; Pasul 2 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@MS;5A7!A#C13'C4' C#B1"D3a1 D3aCCEte*tA5AEtransaction,idA8#CCCCE p(onenum2erAC7CCCCCCCCEorders,leftA3Ere+,-alidatedA#Es(ortnum2erA747"E ser-icenum2erA747"EnetaliasAO:; Pasul 3 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@MS;5A7!A#C13'C4' C#B1"D3a13D3a3FEte*tA>!GHO:5

"

D#C"3"8 18FEtransaction,idA8#CCCCEre+,-alidatedA3E p(onenum2erAC7CCCCCCCCEorders,leftA3Es(ortnum2erA747"EPAG,9AA747"Ese r-icenum2erA747"EnetaliasAO:;

III.

Vodafone Mecanism de functionare

Clientul trimite un sms de comanda catre un numar scurt $de ex )*)+% pentru care primeste un mesa, de informare de la acelasi numar scurt $)*)+% la care tre uie sa confirme prin textul &a, si in functie de creditul disponi il va realiza sau nu o tranzactie valida primind mesa,ul corespunzator de la un numar scurt de taxare asociat $pentru acelasi ex avem 1*.2*%. MediaSat intermediaza comunicatia intre partener si operator pentru clientul respectiv. Schema de functionare

Comunicatia si transmiterea mesa,elor se realizeaza in . pasi prin metoda /##P POS# re0uest catre partener avand urmatorii parametri:
Parametru msgdate te*t re+,-alidated Semnificatie data mesa$ului trimis de catre client% in format &&&&'mm'dd (()mm)ss continutul mesa$ului trimis de catre client statusul de procesare al comenzii% acesta poate lua una din urmatoarele -alori) 1 . cerere ser-iciu din partea clientului / pentru la' urile in s(aring% 0e&1ord'ul de comanda este sta2ilit si configurat3 # . confirmarea ser-iciului de catre client prin trimiterea te*tului 45a6 3 ' confirmarea platii de realizandu'se o comanda -alida catre operator% Pasi 1%#%3 1%#%3 1%#%3

O2s) in cazul in care se primeste eroare de ta*are de la operator /clientul n'are suficient credit3 sau sunt pro2leme la transmiterea mesa$elor% acest status -a fi raportat in etapa de 5eli-er& 4 . eroare de ta*are ' clientul a anulat ser-iciul% prin comanda 4stop6 " . 7ranzactie e*pirata 7 . 7ranzactie anulata /comanda noua3 netalias transaction,id p(onenum2er s(ortnum2er ans1,message orders,left pa&,la servicenumber 8 . 9imita comenzi atinsa V5I% reteaua clientului. id'ul tranzactiei. <nic per tranzactie=operator. numarul de telefon al clientului large account'ul ser-iciului mesa$ul de raspuns pe care'l -a primi clientul in urma mesa$ului de comanda numarul de comenzi ramase in luna curenta large account'ul de pe care se face ta*area si de la care -a primi clientul mesa$ul de ta*are Numarul scurt real folosit de catre clientii finali.Optional. 1%#%3 1%#%3 1%#%3 1%#%3 1 # 3 1%#%3

:aspunsul la postul J77P poate fi)

Raspuns POST O>? O>?te*t message

Semnificatie transmisia si receptia mesa$ului a a-ut loc fara erori transmisia si receptia mesa$ului a a-ut loc fara erori% clientul primimd mesa$ul dorit si sta2ilit de catre partener% e*) un cod pe 2aza caruia clientul se -a putea inregistra ulterior sunt pro2leme de comunicatie si ser-iciul nu este functional% clientul fiind instiintat de acest lucru

!::?te*t message

Exemple: Pasul 1 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@ ans1,messageAAiBcomandatBPromo-areBanuntB.ro. BPentruBconfirmareBtrimiteB5ABlaB747"/costBtotalB".1CB!<:D#27VA3 D#cptBrenuntareBtrimiteBS7OPBlaB747".BInfo D3aBC314C 334EmsgdateA#C13'C4'C#B1"D3aCCD3a#8Ete*tA>!GHO:5 D#C"383 C##Etransaction,idA8#4C11Ep(onenum2erAC7CCCCCCC3Ere+,-alidated A1E s(ortnum2erA747"Eser-icenum2erA747"EnetaliasAV5I Pasul 2 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@msgdateA#C13'C4' C#B1"D3aC1D3a#1Ete*tAdaEtransaction,idA8#4C11Ep(onenum2erAC7CCCCCCC 3Eorders,leftAFFFFEre+,-alidatedA#Es(ortnum2erA747"Eser-icenum2erA747"E netaliasAV5I Pasul 3 URL: (ttps)==secure.partener.ro=sms=mediasat.p(p@msgdateA#C13'C4' C#B1"D3aCCD3a#8Ete*tA>!GHO:5 D#C"383 C##Etransaction,idA8#4C11Ere+,-alidatedA3Ep(onenum2erAC7CCCCC CC3Es(ortnum2erA747"Epa&,laA#43C4Eser-icenum2erA747"EnetaliasAV5I

1C

IV.

Cosmote Mecanism de functionare

Clientul trimite un sms de comanda catre un numar scurt $de ex )*)+% pentru care primeste un mesa, de informare de la numarul scurt asociat $pentru acelasi ex, avem )*)+2% la care tre uie sa confirme prin textul &a, si in functie de creditul disponi il va realiza sau nu o tranzactie valida. MediaSat intermediaza comunicatia intre partener si operator pentru clientul respectiv. In cazul in care clientii Cosmote trimit mesa,e aleatoare la numarul taxa il $ex. )*)+2% acestia sunt contactati de callcenter-ul Mediasat. &aca clientul confirma telefonic ca doreste ac"izitionarea serviciului, operatoarea Mediasat va trimite un email catre partener cu numarul de telefon taxat, data, mesajul SMS-ului si serviciul pe care clientul il doreste. Schema de functionare

11

1#

Comunicatia si transmiterea mesa,elor se realizeaza in . pasi prin metoda /##P POS# re0uest catre partener si are urmatorii parametrii:
Parametru msgdate te*t re+,-alidated Semnificatie data mesa$ului% de forma) &&&&'mm'dd (()mm)ss continutul mesa$ului trimis de catre client statusul de procesare al comenzii% acesta poate lua una din urmatoarele -alori) 1 ' cerere ser-iciu din partea clientului / pentru la'urile in s(aring% 0e&1ord'ul de comanda este sta2ilit si configurat3 # ' confirmarea ser-iciului de catre client prin trimiterea te*tului 45a6 3 ' confirmarea platii de catre operator /clientul a fost ta*at3% realizandu'se o comanda -alida COS % reteaua clientului. id'ul tranzactiei clientului. <nic per tranzactie=operator. numarul de telefon al clientului de pe care s' a realizat comanda large account'ul /numarul scurt3 la care a trimis clientul mesa$% e* 747" mesa$ul de raspuns pe care'l -a primi clientul in urma mesa$ului de comanda numarul de comenzi ramase in luna curenta /porneste de la numarul ma*im de comenzi premise pe luna pana la C3 Pasi 1%#%3 1%#%3 1%#%3

netalias transaction,id p(onenum2er s(ortnum2er ans1,message orders,left

1%#%3 1%#%3 1%#%3 1%#%3 1 #

13

:aspunsul la postul J77P poate fi)

Raspuns POST O>? O>?te*t message

Semnificatie transmisia si receptia mesa$ului a a-ut loc fara erori transmisia si receptia mesa$ului a a-ut loc fara erori% clientul primimd mesa$ul dorit si sta2ilit de catre partener% e*) un cod pe 2aza caruia clientul se -a putea inregistra ulterior

altce-a% e*) sunt pro2leme de comunicatie si ser-iciul nu eroare de sistem este functional% clientul fiind instiintat de acest lucru Exemple: Pasul 1 URL: (ttps)==secure.partener.ro)443=sms=mediasat.p(p@ ans1,messageAAiBcomandatBPromo-areBanuntB.ro. BPentruBconfirmareBtrimiteB5ABlaB747"CD#8costBtotalB".C B!<:D#K7VA D#FD#CptBrenuntareBtrimiteBS7OPBlaB747".BInfo D3A314C 334EMS;5A7!A#C13'C4'C1B11D3AC7D3AC3Ete*tA>!GHO:5 D#C"41871F7Etransaction,idA14171FEre+,-alidatedA1Ep(onenum2erAC7" 477 4C3Es(ortnum2erA747"EnetaliasACOS Pasul 2 URL: (ttps)==secure.partener.ro)443=sms=mediasat.p(p@MS;5A7!A#C13'C4' C1B11D3AC7D3A##Ete*tA>!GHO:5 D#C"41871F7EtelefonAC7" 4774C3Ere+,-alidatedA#Ep(onenum2erAC7"CCC74C 3Es(ortnum2erA747"Eorders,leftA4EnrtelAC7" 4774C3Etransaction,idA14171FE netaliasACOS Pasul 3 URL: (ttps)==secure.partener.ro)443=sms=mediasat.p(p@MS;5A7!A#C13' C4'C1B11D3AC7D3A##Ete*tA>!GHO:5 D#C"41871F7Ere+,-alidatedA3Ep(onenum2erAC7"CCC74C3Es(ortnum2erA747" Etransaction,idA14171FEnetaliasACOS

14

V.

Antifrauda

3iecare client are dreptul de a trimite un numar limitat de SMS-uri pentru a folosi acest serviciu. Sistemul de anti-frauda este conceput pentru protectia clientului si a partenerului prin limitarea consumului lunar. 4umarul de comenzi ramase in cadrul lunii curente este dat prin parametrul orders_left.

Pentru determinarea numarului maxim de comenzi care pot fi efectuate intr-o luna, se utilizeaza relatia: suma_max_la / cost_serv = N + rest, unde rest 5 4 , suma_max_la 6 suma care nu tre uie depasita de un client pe un anumit numar scurt $78% si cost_serv 6 costul serviciului

O servatii: ' ' ' ' la penultima comanda a clientului $4-9%, acesta este instiintat ca va mai putea face o singura comanda in aceasta luna la ultima comanda a clientului $ 4%, acesta este instiintat ca nu va mai putea efectua alte comenzi in luna curenta, in post orders_left 6 2 la comenzi succesoare ultimei comenzi validate $:4% , se intra in frauda si nu se va livra serviciul suma maxima lunara depinde de operator si are urmatoarele valori: Orange 2 !"#$ Vodafone % !"#$ Cosmote &% !"#.

VI.

!rori

In cazul in care serverul partenerului nu raspunde conform protocolului $ex: timeout, internal error, gate a! timeout, etc.% Mediasat nu retransmite POS#-urile /##P. Partenerul va primi prin email POS#-urile pentru clientii taxati de pe pasul . $re0_validated6.%, avand o ligatia sa ofere serviciul respectivilor clienti.

1"