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