SMS subscriptions

Lithuania

 

There are several ways to terminate subscription:

1. user's initiative by sending SMS with special keyword

2. partner initiative by HTTP request

3. other ways (mobile operator, Verozona call center initiative and so on)

 

1. SMS. ACTION=REMOVE

It is a user-initiated subscription termination method.

This service is used after user send a special keyword. User can be unsubscribed from one or more services at once. Vero system send a HTTP request to partner's server with action=remove.

This method also includes "STOP" keyword, that is not shown in your list of keywords.

 

http://yourwebsite.lt/termination/?action=remove&serviceID=97449&mbs_account_id=10310758&mbs_acc
ount_phone=37061630290&mbs_account_ident=&operator=tele2_lt&provider=tele2&country=lt&memberID=26
4411&msisdn=37061630290&phone=61630290&dateAdd=201603221703&key=vVh1OZkPFt8%3D&id=24783174&sdata=
6737981&s1=4060d9e7e85e0525f99662aeab4e1925cc8612fa&s2=Qb3sKLl1f4U%2B%2Fn3zVF%2B4JeFlE1anDm2ggBKx
6dn8dNZnDmWRNW%2F2xvit%2FR4%2FqBqR%2FHmx5BdkiUeGwQpcr4RB0mJdFzKQl58EabJ%2F%2FoOzkdtTZDBfjggifHuKg
69KsobPqJUeGuxbp0y4XngzMh%2BKF1O8F7Irk5XKvmcIRFpzp5w%3D

 

To form queries system uses the following parameters:

 Title  Description  Example
 action  Action title  remove
 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 operator's system
  It can be user's phone number, but in rare cases
 -
 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”
 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  201603221703
 key    vVh1OZkPFt8%3D
 id  Unique request ID  24783174
 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 user was unsubscribed successfuly:

 Response  When to use
 OK  User was unsubscribed.
 User gets a message with successful termination text.
 ERROR  User was not unsubscribed.
 User gets a message with unsuccessful termination text.

 

 

 

 

 

 

 

2. HTTP GET request, partner initiative

It is a partner-initiated subscription termination method.

This service is used when partner wants to terminate subscription. Usually after the user deactivates his account.

To use this type of termination partners must send their server IP address, so Verozona team could provide access for it.

 

To unregister the user partner should send a request at the following address:

http://pre.vero.lt/unreg.php?serviceID=97449&phone=61630290&sdata=6737981

 

To form queries system uses the following parameters:

 Title  Description  Example
 serviceID  Unique subscription service ID  97449
 phone  User's phone number (MSISDN). Last 8 characters  61630290
 sdata  User code in partner's system
 Up to 50 characters
 6737981

 

 

 

 

 

Important! Partner on its own initiative may terminate subscription if the server's IP address is registered in Verozona system.
One partner can have more than one IP, but the same IP can't belong to different partners.

 

 

3. Other ways

Other ways how users can terminate their subscriptions:

 

In all the above-mentioned cases, the user's subscription will be terminated in Vero system first.

Your system will be informed about termination by HTTP GET method the way it is defined in first case (1. SMS. ACTION=REMOVE)

 

EXAMPLE (REFERENCE LIBRARY)

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

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

Read more