One-click services

Registration

1. Browsing user presses the link that directs user to the Vero system's service purchasing environment.

2. The user is asked whether he agrees to register to the subscription.

3. After user agrees to pay Vero system charge money from user.

4. After successful payment Vero system registers user to subscription.

5. About successful payment Vero system informs partner via link (URL) that now has additional payment parameters.

6. The user is returned to the partner site. About successful registration user is informed via SMS.

7. If the user is registered successfully and he does terminate a subscription, after a specified period the system will automatically try to perform billing to extend subscription.

 

 

 

preengine-pre.vero.lt_v3_20160225_wapveikimas_640_640

The service is used to pay for services and to register to subscription via mobile Internet. If user is connected via Wireless he won't be able to pay for the service - the system does not recognize the user's phone number and can not charge the money.

We recommend to use an identification service before registration or when user visits partner's project. This way you can find out detailed user information (country, language, operator, phone number and so on.), and you will be able to form a payment page.

More about identifying users read in "User identification"

 

Operator Telia Lithuania users, while trying to make a payment, falls in standby site with the info text: "We are trying to charge. After you get an SMS, press this link: proceed >>". The user gets a successful payment message with the service name and a link to a paid service. Even if user leaves one-click service page, he can proceed with the registration by clicking a link in the SMS.
If the partner receives a billing errors, but they are not processed correctly (HTTP status is not 200), a Telia Lithuania Consumers billing will not work.

Also Telia users will have confirm subscription with SMS "TAIP". If user does not confirm a subscription within 1 hour service will be provided for one period.

For „Bitė Lietuva“ users you can give only one week or one month subscription periods. If you want to use different periods for other operators, you can do it. That means that „Bitė Lietuva“ users will be charged once a month. In this case, the price and the period needs to be indicated separately.

 

1. FORWARDING USER TO VERO SYSTEM

To charge the user, it must be directed to the Vero system's address http://bill.vero.lt/wap/register with the formed GET parameters:

Example of address where the user will be redirected (it is used signature security password "test"):

http://bill.vero.lt/wap/register?session_id=debaf588e8ebadfe97a6ae38ff95beef&after_register=yes&
s=2&si=&i=1255530969&u=http%3A%2F%2Fmbs.vero.lt%2Fsimple%2Fwap_register.php&s1=01cb763307dd28851
f8ccf3192b5fcbfd8ccd858

 

In addition you can add any number of parameters. Later they will be added to the address to which user will return to the project, together with payment information. However, parameters can not be with these titles: 's', 'si', 'i', 'p', 'pc', 'u', 'un', 's1', 's2', because these parameters are used to transfer the main information.

In order to avoid double payments, it is not enough just to generate a payment link, when the purchase button is pressed. In this case, pressing the same button 2 times in a row, you will generate 2 different purchase requests, and they both will be paid. We recommended that the purchase button would be generated as the unique purchase link with a unique parameter i.

 

Single-payment/register GET parameters to make a request to Vero system

 Title  Type  Mandatory  Description  Example
 s  int  yes  Subscription service ID  2
 si  string  no  User identificator in subscription service
 (eg. nickname).
 Can be used, if same user can register to the service
 with different accounts.
 -
 i  string  yes  External system unique identifier
 that describes the ongoing payment event (transaction).
 Parameter also is used to
 avoid double payments,
 thats why it should be unique each time
 for the service or at least for the user.
 If you do not save payment events in your side,
 you can specify the time when link was generated.
 1255530969
 p  int  no  Registration (first period) price, indicated with cents.
 It is required when registration has several prices.
 -
 pc  string  no  Registration currency (ISO 4217 standard).
 Required when indicating parameter p.
 -
 u  string  no  Encoded ( urlencode ) URL,
  where the user should be redirected
 after registration.
 If this parameter is not indicated,
  user will be redirected to service URL,
 indicated during creating service.
 http%3A%2F%2F
 mbs.vero.lt%2F
 simple%2Fwap_register.php
 un  string  no  Encoded ( urlencode ) URL,
 if user should be directed to other link
 after unssuccesful registration.
 If this parameter is not indicated,
 user will be redirected to service URL, indicated in parameter u
 -
 s1  string  yes  Security signature (lower credibility)  -

 

 

2. RETURNING USER TO PARTNER SYSTEM

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

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

http://mbs.vero.lt/simple/wap_register.php?session_id=debaf588e8ebadfe97a6ae38ff95beef&after_reg
ister=yes&s=2&si=&sr=active&srs=active&i=1255530969&t=2331494&a=1&s1=dfbb0af21a09516b73946bb9945
8499f1ef6b081&s2=HpwXNO%2Fr5Yhd3g00yIeHKEnZsuYJ7UdGTHnj06n5T%2FJQ%2BDGZG8tPaMYH6rCI9Febv8UDtNgQL
eXi7h21diQUxEirxNjb1AqdvSOi%2FbO3IqCvuvGS65t7EIom5E9tGL77wdtorKpwgNkbfszQAgBEjard7scWiwt0Jbhut9E
CDik%3D

 

 s  int  yes  Subscription service ID  2
 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"
 active
 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"
 active
 i  string  yes  External system unique identifier
 that describes the ongoing payment event (transaction).
 1255530969
 t  int  yes  Unique identifier of payment event (transaction) in MBS system.  2331494
 a  int  yes  Unique identifier of successfuly billed user in MBS system (account_id)  1
 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.

It is necessary to check subscriber status (parameters 'sr' or 'srs'). This ensures that user will not get service for expired registration.

After user gets back to the site you can check whether or not the same user is registered and browsing the service (the parameter 'a'). This ensures that you will not provide service even after imitating foreign registration return.

Usually subscription report register Vero system sends to the partner in few seconds or minutes, but sometimes it may be delayed.

 

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