One-click services

User identification

User identification is a necessary element to charge the consumer via mobile Internet.

Identification allows to recognize the user - country, language, operator, phone number.

User identification process:

1. Partner's system in order to identify the user, redirects him to Vero identification system (http://bill.vero.lt/identify) with special parameters.

2. Vero system identifies the user.

3. The user is redirected back to the Partner's system with additional identification parameters in the link (URL).

Using identification service user needs to be identified once. For that parameters transmission mechanism is used, which allows to add the selected parameter (eg .: session), which ensures that the user will not have to be re-identified. Services that will identify the same user repeatedly will be automatically disconnected.

1. Forwarding to VERO SYSTEM

In order to identify the user, it must be directed to the Vero identification system to http://bill.vero.lt/identify with identify parameters.

Example of the address where the user will be redirected:

http://bill.vero.lt/identify?i=1&t=1255617369&u=http%253A%252F%252Fmbs.vero.lt%252Fsimple%252Fwa
p_identify.php&session_id=d9532e97acebdd356fc465df249b4bce&after_identify=yes&s1=ed168dbd6ba4cef
a723144dcf2839fa5a8fa5030

Identify parameters

In addition you can add any number of parameters. After identification of the user, these parameters will be added to the address to which user will return, along with the identification data. However, parameters can not be with these names: 'i', 's', 's1', 's2', 't', 'ac', 'al', 'op', 'a', 'oi', 'om', 'si', 'sr', 'srs', 'sid', 'u', 'k', because these parameters are used to transfer the main information.

Title	Type	Mandatory	Description	Example
i	int	yes	Identification service ID. Is used to recognize which external system requests identification.	1
t	string	no	Išorinės sistemos identifikatorius, nusakantis identifikavimo įvykį.	1255617369
u	string	no	Encoded ( urlencode ) URL, where the user should be redirected after identification. If this parameter is not indicated, user will be redirected to service URL, indicated during creating service.	http%253A%252F%252F mbs.vero.lt%252F simple%252Fwap_identify.php
si	string	no	User identificator in subscription service (eg. nickname). Can be used, if same user can register to the service with different accounts.	-
s1	string	yes	Security signature (lower credibility)	-

2. Returning user to partner system after identification

So after a successful and an unsuccessful identification the user will be directed to the service address. There will be attached those parameters that external system has requested during event.

Example (there is a password „test“ used in security signature):

http://mbs.vero.lt/simple/wap_identify.php?i=1&t=1255617369&ac=LT&al=LT&op=bite_lt&a=1&si=&sr=re
moved&srs=subscribe_cancel&session_id=d9532e97acebdd356fc465df249b4bce&after_identify=yes&s1=0bd
58d0c4ac6d60d84f724e93fcdeede091c1171&s2=nAMQm9hAr9ExY2LYIqG2KR9V8vARbuiACtNUOMvJf6RbJ%2Bj%2B4SY
O3gkTKOF3tiscfDkkdc6GHVOekcBUpYTr6wDLzN2zctI4Nz3ZxA3qkyXjm4U3Rec4GjBHA87Jj43SC%2FCLBGvICgpxELUoD
GITxFxkE1yxDrgHjiph4HYt8kw%3D

Parameters:

Title	Type	Mandatory	Description	Example
i	int	yes	Identification service ID. Is used to recognize which external system requests identification.	1
t	string	no	Transaction. External system's parameter, indicating identification event.	125561739
ac	string	yes	User country indicated with ISO 3166-1(Alpha-2) format.	LT
al	string	yes	User language indicated with ISO 639-1 format (Lithuanian language “LT”)	LT
op	string	no	User operator if user is connected via Mobile Internet (eg.: tele2_lt, bite_lv, era_pl, etc.)	bite_lt
a	int	no	A unique user identifier in the MBS system, if user is connected via Mobile Internet	1
si	string	no	User identifier in subscription service (eg. nickname). Is used if user can register to the same subscription many times with different identificators.	-
sr	string	yes	Main subscriber status (status), which indicates user activity in subscription. You can find a list of all possible values in "Subscriber status"	removed
srs	string	yes	Additional subscriber status (state), which specifies a reason of failed payment. You can find a list of all possible values in "Subscriber status"	subscribe_cancel
oi	string	no	WAP user identifier in operator system. Unique in each operator's system. It can be a phone number, but only in rare cases.	-
om	string	no	User phone number (MSISDN). Determined not to all operators.	-
ot	string	no	User payment type (prepaid, postpaid, testing, unknown). Determined not to all operators.	-
s1	string	yes	Security signature (lower credibility)	-
s2	string	yes	Security signature (highest credibility)	-

Attention!

It is necessary to check security signature after user comes back to service address (parameters 's1' or 's2'). This ensures that an appeal was made by the MBS.

If MBS identification system is not able to recognize mobile user, parameter "a" will be equal to "0" when coming back to the project ( without the quotes )

When Vero identification system fails to recognize the user and the service has activated "debug" mode, for user it will be shown an identification error and he will not be returned to the project. With status "Normal" unidentified user is returned to the project with the "a" parameter equal "0" (without the quotes).

Example (reference library)

PHP library used to connect to the Vero system, you can download here: MBS library

Unsubscribe

To unsubscribe service in Lithuania send SMS to short code 1679. Message price is 0.09 Eur.