Rate scale

Worldwide coverage has always been one of SmsCoin's greater advantages. Products and services our partners offer are available in 88 countries across the globe. Rates list includes over 500 rates on which we and our partners are operating. Additionally, we are constantly working to add new countries to the list, as well as doing everything to maximize rates diversity and to improve working conditions of currently operating rates. It is almost impossible to follow up the constant changes in our system, and to make necessary modifications to website instructions manually on time.

Therefore, we believe it is necessary to generate payment instructions on your website automatically. This does not concern those who use our standard solutions and interfaces. For those of you who use their own payment pages interfaces, we have developed a convenient solution to automatically update of the rates, short codes and keywords.

For each service connected to your website there is a separate rate scale stored on our server, which is always up to date according to individual control panel settings in your account, and rates operating in our system. Rate scale is available in two popular data formats — XML and JSON, both of which are easy to integrate with all the popular server-side scripting languages.

Based on data stored in individual rate scale, payment instructions should be generated on your websites. We recommend to store the rate scale on your server, set to automatic update every hour. Thus, this is the only way to guarantee your users the availability of correct and up-to-date instructions for sending SMS messages. Besides, by reducing the number of requests to our server you increase your website functionality.

Various implementation examples could be found here.

Rate scale parameters

Parameter Type Description
country char(2) Country code (2 letters).
country_name char(64) Name of the country.
code char(64) Mobile carrier code.
name char(64) Mobile carrier name.
number int Short code SMS-message is sent to.
prefix char(16) Keyword in SMS-message body.
Message format: keyword parameter settings space service_ID
rewrite char(16) Personal keyword associated with this service. If parameter value is not empty:
Message format: settings of rewrite parameter
otherwise keyword parameter settings is used prefix
price float SMS-message price in local currency units (parameter currency).
vat bool If value set to 1 — price price parameter includes VAT; 0 value — VAT is not included.
usd float SMS-message price in USD (VAT excluded).
profit float Your percentage of SMS price in USD.
currency char(64) Currency unit in specific country.
special char(128) Additional information which has to be displayed in instructions.

Rate scale for sms:key service

Structure:

Rate scale structure affected by 2 parameters in service settings – list of connected countries and SMS-message price.

From the list of currently active rates, the closest rate to the one set by you (upwards) is selected automatically for each and every country. Countries, where the price set by you is not supported by the mobile carriers, are excluded from the list.

Rate scale example:

XML format: http://service.smscoin.com/language/english/xml2/key/200001/

JSON format: http://service.smscoin.com/language/english/json/key/200001/

your sms:key service ID replaces the '200001' field.

Rate scale processing example for displaying SMS-message instructions for user:

Usage:When SMS-payment integration is needed and our standard solution unsuitable.

XML format: Download

JSON format: Download

Rate scale for sms:bank service

Structure:

Rate scale structure affected by the list of countries connected in the service settings.

For each and every country connected all operating rates are selected automatically.

Rate scale example:

XML format: http://service.smscoin.com/language/english/xml2/bank/2/

JSON format: http://service.smscoin.com/language/english/json/bank/2/

your sms:bank service ID replaces the '2' field.

Rate scale processing example for generation of transaction initiation form:

Usage: User is given the opportunity to choose the desired payment amount (choosing the country, mobile carrier and the transaction sum).

XML format: Download

JSON format: Download

Rate scale for sms:transit service

Structure:

Rate scale structure affected by the list of countries connected in the service settings.

Such script automatically chooses any rate there is among mobile carriers according to selected countries.

Rate scale example (Static rate scale):

Such script automatically chooses any rate there is among mobile carriers according to SMS cost specified in settings. The cost is rounded up to the closest existing rate. Countries, where the price set is not supported by the mobile carriers, are excluded from the list.

XML format: http://service.smscoin.com/language/english/xml2/transit/10000/

JSON format: http://service.smscoin.com/language/english/json/transit/10000/

Rate scale example (Dynamic rate scale):

In case you wish to receive all rates higher than certain amount, you may specify it in “Cost” field and append /all to the end of your rates sheet URL string.

Such script automatically chooses all existing rates equals to or higher than the cost specified in sms:transit settings. Countries, where the price set is not supported by the mobile carriers, are excluded from the list.

If you wish to receive the entire list of rates in our system, in chosen countries set the service cost to 0.

XML format: http://service.smscoin.com/language/english/xml2/transit/10000/all

JSON format: http://service.smscoin.com/language/english/json/transit/10000/all

your sms:transit service ID replaces the '10000' field.

Rate scale processing example for displaying SMS-message instructions for user:

Usage: Displaying instructions for sending SMS-message (choosing the country, mobile carrier and the transaction sum).

XML format: Download

JSON format: Download

Frequently asked questions

I have my own personal keyword associated with my service – will my users be able to see it in the instructions for SMS-message sending?

If the instruction for SMS-message sending is generated according to rate scale for this specific service, it will be replaced automatically in all rates where the keyword is supported. Otherwise, the standard SMS-message format will be displayed.

How often should I renew the local copy of my rate scale?

It should be updated at least once an hour. Thus you won't overload your server and your users will receive the correct instruction faster than in case of requesting our server constantly.

What will happen if your server becomes inaccessible?

In case you work with a local copy of your rate scale – you will continue working accordingly, it won't change at the time of updating.

Can I receive the names of the countries and mobile carriers in a different language?

The rate scale is available in different languages ad well.
For example, in the following link: http://service.smscoin.com/language/english/xml2/transit/10000/
just replace the word english with a different language such as Spanish or any other desirable language.

List of supported languages:

arabic
belarusian
czech
english
estonian
french
german
greek
hebrew
latvian
lithuanian
polish
portuguese
portuguese_br
romanian
russian
slovak
spanish
swedish
turkish
ukrainian

Share |