1. User sends SMS with registration keyword.

2. By keyword Vero system identifies wich service user wants to subscribe.

3. Vero system informs partner about SMS. Partner responds if user can be registered to subscription. (action=sms)

4. If partner allows it Vero system registers user to subscription immediately. Vero system informs Partners' server about successful registration. (action=register)

5. About successful registration user is informed via SMS.

6. If the user is registered successfully and he does terminate a subscription, after a specified period the system will automatically try to perform billing to extend subscription.

Attention! For „Bitė Lietuva“ users you can give only one week or one month subscription periods. If you want to use different periods for other operators, you can do it. That means that „Bitė Lietuva“ users will be charged once a month. In this case, the price and the period needs to be indicated separately.

 

1 request. Action=sms

Upon receipt of SMS Vero system informs partner server via HTTP request. Vero reffers to the URL address that is agreed before („Data transfer URL“). Data is provided via GET method:

http://yourwebsite.lt/order/?From=vero&ModuleName=regkey&Phone=61630290&Number=1679&Provider=
tele2&Sms=regkey+6737981&TransId=6f04e8e340e78129cd710c693cd0bbeef18ae7cc&msgId=29091729&smsc=tele
1ampaction=sms&serviceID=pre-97449&mbs_account_id=10310758&mbs_account_ident=0037061630290&mbs_acc
ount_phone=37061630290&memberID=264411&sdata=6737981&msisdn=37061630290&phone=61630290&operator=te
le2_lt&provider=tele2&country=lt&s1=aa3f2299452f3d5d6af096be6a2e44a1e2b36684&s2=DEWt%2BFuPpTqljWLi
C3OgxXHCBPh7hBa3Zl6GfIBmsf1WwDkzfGyJJQ%2FXIo4%2BjgXkMCaJDUH7E%2BhtHYAujA52WIc%2BMqKZONQ3eXUprDpBNQ
IzXAwKscocSP7BTLx0gq6bHdNSMw25LOL5q1f2sizFjxxepNpZKJLlvCFJeBC1cB

 

To form queries system uses the following parameters:

Title	Description	Example
From	Service provider description.	„vero“
ModuleName	Keyword, according to which the service has been identified	„regkey“
Phone	User's phone number (MSISDN). Last 8 characters	61630290
Number	A short phone number where SMS was sent (4 digits).	1679
Provider	Users' operator name in users country	„tele2“
Sms	Full SMS text (not longer than 160 symbols).	„regkey+6737981“
TransId	Transaction identifier, unique for each incoming message.	6f04e8e340e78129cd710c693cd0bbeef18ae7cc
msgId	Message identifier, unique for each incoming message.	29091729
smsc	SMS center	„tele1“
action	The parameter that describes if this is the incoming message query	„sms“
serviceID	Service id number where user will be registered	„pre-97449“
mbs_account_id	Unique user identifier 2 in Vero system	10310758
mbs_account_ident	WAP users' identificator in operators' sytem.  Unique in each operators' system.  It can be a phone number, but on rare cases.	0037061630290
mbs_account_phone	User's phone number (MSISDN)	37061630290
memberID	Unique user identifier 1 in Vero system	264411
sdata	(not necessary) Users' code in partners' system.  Up to 50 characters.	6737981
msisdn	User's phone number (MSISDN)	37061630290
phone	User's phone number (MSISDN).  Last 8 characters	61630290
operator	Operator name.  Consisting of the operator's name, „_“ and country abbreviation.	„tele2_lt“
provider	Users' operator name in users country	„tele2“
country	Country code	„lt“
s1	Security signature (lower credibility)	-
s2	Security signature (highest credibility)	-

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Partner has to respond if user can be registered:

Response	When to use
OK	Partner allows user to register
OK;2012-02-10+17%3A18%3A05;81.7.76.85	Partner allows user to register,  specified last-login data
ERROR	Partner does not allow for users to register

 

 

 

 

 

 

2 request. Action=register

If partner allowed for user to register, Vero system adds user to subscripbers list and sends onother HTTP GET request to partner. With 2nd request you will get „action=register“ (or „action=resume“, if user was a subscriber before):

http://yourwebsite.lt/subscription/?action=register&serviceID=97449&mbs_account_id=10310758&mbs_ac
count_phone=37061630290&mbs_account_ident=0037061630290&operator=tele2_lt&provider=tele2&country=l
t&memberID=264411&msisdn=37061630290&phone=61630290&dateAdd=201503241052&price=145¤cy=EUR&key=dqIV
8SZ1L3c%3D&id=23617854&sdata=6737981&s1=ae4fd1b8da5eb4d3389be36f2aa8b97dc13f788c&s2=w4ejN%2FUkugEX
6Q85OEkQ6Na4yYXs9H9z11MjBuU29Dm8o81f9D5nPmmSNsdKI7xPzDSaLVCJG3996io6uBg4MLgX%2B9eNR4nYdNDFynuXb4b6
Iw6f0V0dsA7NRJkfaIKa3udThz4vDwvAaS%2BU%2FlooiaQtNM36TzJU53Z%2FyiJrWlM%3D

 

To form queries system uses the following parameters:

Title	Description	Example
action	Action name	register
serviceID	Subscription service unique ID	97449
mbs_account_id	Unique user identifier 2 in Vero system	10310758
mbs_account_phone	Vartotojo telefono numeris (MSISDN)	37061630290
mbs_account_ident	WAP vartotojo identifikatorius operatoriaus sistemoje.  Unikalus kiekvieno operatoriaus sistemoje.  Tai gali būti telefono numeris, bet tik retais atvejais	0037061630290
operator	Vartotojo operatoriaus pavadinimas.  Susidedantis iš operatoriaus vardo, „_“ ir šalies trumpinio	„tele2_lt“
provider	Vartotojo operatoriaus pavadinimas šalies viduje	„tele2“
country	Šalies kodas	“lt”
memberID	Unique user identifier 1 in Vero system	264411
msisdn	User's phone number (MSISDN).	37061630290
phone	User's phone number (MSISDN). Last 8 characters	61630290
dateAdd	Action completion date (minutes accuracy)	201503241052
price	Price, how much user was changed, indicated with  cents (sending with actions: 'register', 'pay', 'resume')	145
currency	Currency that is sent together with 'price'	EUR
key		dqIV8SZ1L3c%3D
id	Unique request ID	23617854
sdata	(not necessary) Users' code in partners' system.  Up to 50 characters.	6737981
s1	Security signature (lower credibility)	-
s2	Security signature (highest credibility)	-

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Partner responds if user was provided by service:

Response	When to use
OK	Service is provided.  User gets the confirmation SMS.
OK975	Service is provided.  User gets the confirmation SMS,  where unique code is specified.  Before creating new service you should infor Vero if such code will be given.
ERROR	User did not get service  User gents the information about registration failure.

 

 

 

 

 

 

 

 

Parametro "action" reikšmės

Action	Description	Parameters
sms	A request before users' registration	Depends on service configuration:  1. sms – Message text or its fragment  is managable.  2. sdata – Users' code can be managed  in partner system
register	New user just registered	-
suspend	User is suspended for some time	-
resume	Users' membership was renewed after suspension (payment)	-
pay	Membership extended(payment)	-
remove	User unsubscribed	-
approve	Just for Telia, user confirmed a registrationm   by sending TAIP message  (it can be enabled on partners request)	-
approve_renew	Just for Telia, user confirmed an extention  by sending TAIP message  (it can be enabled on partners request)	-
check	Just for Telia, checks last login date  (WEB visit, login to account)	Jei gaunama užklausa „check“,  reikia grąžinti vartotojo duomenis projekto pusėje:  1. last_login_date – Paskutinio apsilankymo  projekte data. Arba tuščia eilutė „“,  jei nežinoma;  2. last_login_ip – Iš kokio IP jungtasi  į projektą. Arba tuščia eilutė „“, jei nežinoma;    Pavyzdys:  OK;2012-02-10+17%3A18%3A05;81.7.76.85