SMS services

HTTP requests

After a user send a SMS, it is accepted by Vero system.

Vero system performs money charging process.

By keyword Vero system sets a partner, which is informed about SMS via HTTP GET request.

Partner process the message and returns HTTP response to Vero system. Partner can specify SMS text that will be sent to user.

 

URL PARAMETERS AND RESPONSES

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:

Example of address how SMS data will be sent:

http://yourwebsite.lt/vero.php?From=vero&action=sms&ModuleName=ADV&AfterText=12345&Msisdn=3
7065841777&Phone=65841777&Number=1679&Operator=bite_lt&Provider=bite&Country=lt&Sms=ADV+1234
5&TransId=18f121349710e05ce2ac9f665f9cac5c5d577760&msgId=28801224&status=commit&state=op_done&smsc
=bite&mbs_account_id=2&mbs_account_ident=2215320&mbs_account_phone=37065841777&price=87¤cy=EUR&Tim
estamp=1423379369&Date=2015-02-08+09%3A09%3A29&retry=1&s1=be4ac2a35c6b7e7ac94b3233dc0eeaf709c785c2
&s2=MCrS5RtfdVLtoJUlWkdx36bWiBonmzGhmUoPdKgnUQorwTRTfP05IwGbBUtjvUloImozvY9IKIOtkDRRIaPtu%2BkoXcZZ
U8WZDm%2FO2WT5qkBhbg4uIbq3M3JXiD1ZbLhXyq%2B00g%2BeLBSdrJI%2BKTUH5QnfpnZYXQ%2F4KyfJvfSv4D8%3D

According to the data provided in the URL pick the information you need by using HTTP GET method. For example.:

$from = $_GET['From'];
$module = $_GET['ModuleName'];
$userphone = $_GET['Msisdn'];
$userid = $_GET['AfterText'];

More about GET method: http://ocsigen.org/howto/parameters

 

To form queries system uses the following parameters:

 Title  Description  Example
 From  Service provider description.  „vero“
 Action  The parameter that describes if this is the incoming message query  „sms“
 ModuleName  Keyword, according to which the service has been identified  „ADV“
 Msisdn  User's phone number  37065841777
 Phone  User's phone number (MSISDN). Last 8 characters  65841777
 Number  A short phone number where SMS was sent (4 digits).  1679
 Operator  Operators name.
Consisting of the operator's name, „_“ and country abbreviation.		  „bite_lt“
 Provider  Users' operator name in users country  „bite“
 Country  Country code  „lt“
 Sms  Full SMS text (not longer than 160 symbols).  „ADV 12345“
 msgId  Message identifier, unique for each incoming message.;  28801224
 retry  The number describing how many times message is forwarded. It may not be specified.  0
 price  Price indicated with cents  87
 currency  Currency (ISO 4217 standard)  EUR
 s1  Security signature (lower credibility)  -
 s2  Security signature (highest credibility)  -

 

After processing HTTP GET request partner must form text line response: „{RESULT};{PARAMETER1};{PARAMETER2};{PARAMETER3}“. The logical parts of response must be separated by sign „;“. All parameters must be coded (urlencode).

 

Response example: “SMS; Your ad was activated! Ad ID A4074294”

 

 Result  Description  Parameter
 Not specified

 1. Partner did not accept request.

 2. Service was not provided.

  -
 ERROR

 1. Partner accepted the request.

 2. Service was not provided.

 3. User gets the SMS about error.

  1. sms – Message text about error;
 SMS

 1. Partner accepted the request.

 2. Service was provided.

 3. User gets the confirmation SMS.

 1. sms – Message text;

 2. ident - (not necessary).
 Used when partner wants to add some identifier for message,
 for example, advertisement id number;
 PUSH

 1. Partner accepted the request.

 2. Service was provided.

 3. User gets a WapPush message.

 1. url – Message URL address;

 2. sms – Message text;

 3. ident - (not necessary).
 Used when partner wants to add some identifier for message,
 for example, advertisement id number;
 NONE

 1. Partner accepted the request.

 2. Service was provided.

 3. User does not get any message.

 1. ident - (not necessary).
 Used when partner wants to add some identifier for message,
 for example, advertisement id number;

 

 

When response is not specified Vero system suspects that partner script is now working correctly. User gets a message that user server was unreachable: „Siuo metu paslauga teikiantis serveris nepasiekiamas, bandykite veliau.“

 

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