eXTReMe Tracker
Our phone number
+371 6-7887-000
 
 
A convenient micropayment system for selling your resource's services
The client can pay for the provided service easily and quickly by sending an SMS to our short number
 

SMS solutions / How to connect

We have developed several ways of notification about an SMS-query being received for customers' convenience: using SMPP protocol, alerting the client via e-mail and the most popular way - through HTTP protocol by using POST and GET methods.

Distinctive features of an HTTP protocol connection


Having received an SMS-query from a client, we perform two HTTP GET/POST requests for a prearranged script in your system or website to report the data at hand.

The first request is meant to deliver the information about the messages received. Moreover, you can set any SMS price when composing a reply to the first request, which depends on the message text.

http://www.yourpage.com/sms.php?sms-id=%sms-id%&operator-id=%operator-id%&from=%from%&to=%to%&text=%text%&service-id=%service-id%

If you are willing to change the rate of an SMS-query, you will need to indicate that in the header:

header("x-esteria-price: 1.25"); // pricing for 1.25 Ls
header("x-esteria-price: 3.00"); // pricing for 3.00 Ls

The price is indicated in local currency in X.XX format (otherwise the base service price is applied)

The second
request is identical to the first one with the exception of it containing an additional parameter charged=1, which implies that the money was successfully deducted from the client's mobile account or added to his/her phone bill, depending on the contract with the operator (postpay/prepay).

http://www.yourpage.com/sms.php?sms-id=%sms-id%&operator-id=%operator-id%&from=%from%&to=%to%&text=%text%&service-id=%service-id%&charged=1

For your attention:
We recommend providing the service to the client ONLY after receiving the second request. Otherwise ESTERIA does not guarantee payment for the respective SMS-query.

Parameter interpretation:

 Parameter name
 Description
 SMS-ID  unique query identifier varchar(40)
 FROM  sender's number with country code, for instance 37126300680
 TO  addressee's number with country code, for instance 371144
 TEXT  text sent by the subscriber. Not limited by length of SMS
 CHARGED  payment identifier (present only in the second query)
 OPERATOR-ID  unique operator's identifier
 SERVICES-ID  unique identifier for your service

Additional parameters can be employed for your convenience, if necessary. For example, service name or index number of the query for the current day/week/month.

As for the SMPP protocol connection, all matters are discussed individually with every client. We try to meet every client's demands, in order to speed up the connection process and decrease the workload.

For your guidance
  1. Our system operates on several servers; therefore, queries can have different IP addresses.
  2. We use a number of independent Internet connections (from different Internet providers), which significantly decreases the possibility of system malfunction due to Internet instability.
  3. In case your script is unavailable in the process of an SMS-query being sent/received, we will send repeated requests, until we receive a successful reply from your script.
  4. The ability to determine peayment price significantly broadens your capabilities and simplifies your working with our system.
  5. By using our ONLINE-statistics you can look through all requests for your script, as well as all the replies to it. That essentially simplifies the intergation of SMS-billing.
  6. Having received a request from a subscriber once, you are able to send him/her a repeated message with information (SMS-subscription).
  7. We maintain close control of SMS-queries, which very often allows to avoid related fraud.
If you have any questons left, please contact our support at info@esteria.lv or 67887000 !
We are always glad to help!
Esteria © 2009. All rights reserved.
Our e-mail address: info@esteria.lv