SMS subscriptions

Lithuania

 

1. Vero system waits for the time to extend a subscription. After it reaches that point it tries to automatically charge user.

2. If the subscription was extended successfuly, Vero system appeals to partners' server by HTTP GET request and transmit information with user status (action = pay or action = resume) .Partner returns an answer if user was successfully provided with service.

3. If Vero system can't extend the subscription because of user's lack of money or a mobile operator's failure, system set the next expected subscription extention time. User gets suspend status (action = Suspend) .

4. If partner provides services to the user, partner returns "OK" (without quotes) to REGISTER or RESUME. About successful subscription extension Vero informs the user via SMS.

Attention! Depending on the user used operator there can be some exceptions for registration or subxription extentions. Read more: "Payment exceptions".

 

Request. Action=pay

After new user sign up, the old unsubscripbe or after the temporary suspension of membership, Vero server informs partners' server by HTTP queries. EG.:

http://yourwebsite.lt/extention/?action=pay&serviceID=97449&mbs_account_id=10310758&mbs_account
_phone=37061630290&mbs_account_ident=&operator=tele2_lt&provider=tele2&country=lt&memberID=264411
&msisdn=37061630290&phone=61630290&dateAdd=201603221103&price=300¤cy=EUR&key=3lDl%2B%2FgLhCM%3D&i
d=24780358&sdata=6737981&s1=6696fa94e2e800537e246703994767ff08acb928&s2=XvUCQmySAjW%2Fzihw9y38IWk
tPgm%2FGak7tul5IvatDzlScMkial%2BDlMyj%2FtjmyWPom7r%2BD06EBCs4u8Q4X3hJKLfD4LXesrZ0K4sO4iVdPndJgM%2
BnessfkE0aN7qJWdT0hFB46jN%2FD7N3HMZZBQM7971r29M7UBBGemz%2FpIlfnww%3D

 

To form queries system uses the following parameters:

 Title  Description  Example
 action  Action title  pay
 serviceID  Unique subscription service ID  97449
 mbs_account_id  Unique user identificator 2 in Vero system  10310758
 mbs_account_phone  User's phone number (MSISDN)  37061630290
 mbs_account_ident  WAP user identifier in operator system
 Unique in each operators system
 It can be users phone number, but in rare cases		  0037061630290
 operator  Operatos name.
 Consisting of the operator's name, „_“ and country abbreviation.		  „tele2_lt“
 provider  Users' operator name in users country  „tele2“
 country  Country code  “lt”
 memberID  Unique user identificator 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 with minutes accuracy  201603221103
 price  Price, how much user was charged
  Price indicated with cents (just for actions: 'pay', 'resume')		  300
 currency  Currency sent along with the parameter 'price'  EUR
 key    dqIV8SZ1L3c%3D
 id  Unique request ID  24780358
 sdata  (Not necessary) User code in partner's system
 Up to 50 characters		  6737981
 s1  Security signature (lower credibility)  -
 s2  Security signature (highest credibility)  -

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Partner respond if service was given:

 Response  When to use
 OK  Service was extended.
 User gets a message with successful extention text.
 ERROR  Service was not extended
 User does not get any message.

 

 

 

 

 

 

 

PARAMETER "ACTION" VALUES in active subscription

 Action  Description  Parameters
 pay  Subscription extended (payment)  -
 remove  User unsubscribed  -
 suspend  Subscription was temporarily suspended  -
 resume  Subscription was reactivated after temporary suspention
 (payment)		  -
 approve_renew  Just for Telia, user approved subscription extention
 by sending a message TAIP (activated in partners behalf)		  -
 check  Only Telia, check when subscription was used the last time
 (WEB visit, login, etc.)		  If a request „check“ is received,
 user data must be returned
 on the project side:
 1. last_login_date – Last login
 to the project date. Or empty string „“,
 if unknown;
 2. last_login_ip – Last login to the project
 IP address. Or empty string „“, if unknown;

 

 Example:
 OK;2016-02-10+17%3A18%3A05;81.7.76.85

 

 

 

 

 

 

 

 

 

 

 

 

 

 

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.

Read more