Finland Elisa Direct operator billing
Direct Operator Billing Finland Elisa
MSISDN Forwarding is a process that enables you to capture a phone number (the MSISDN) for billing the end user via an approved flow between the mobile networks (the MNOs), MessageCloud’s platform, and your server.
Now available in Finland for the first time, MSISDN Forwarding enables simpler premium rate services via MessageCloud's APIs, targeting 4.8 million mobile subscribers.
Please note that each of the MNOs in Finland implement MSISDN Forwarding in quite different ways, so you will need to ensure you take into account the differences. Our APIs will help you to integrate both kinds of implementation.
Together, Elisa and Saunalahati control 37% of the Finnish mobile market. Elisa acquired Saunalahati in 2005. Saunalahati is an MVNO, or virtual operator, which has its own branding but is powered by the Elisa mobile network, which means the approach to these MNOs is the same.
To use Elisa/Saunalahati MSISDN Forwarding, you will need to call our Retrieval API to request the MSISDN. Unlike Sonera, you cannot receive the MSISDN directly via Elisa/Saunalahati header enrichment.
Once you have the MSISDN, either through an API call or header enrichment, you can use it to complete the charge against the end user’s phone bill.
Transaction Flow
Making a billing attempt
You should send your HTTP GET requests to the following URL:
http://client.txtnation.com/finland/elisa_charge.php
The API expects the following parameters to be sent:
Variable Name | Example | Description | Restrictions |
---|---|---|---|
cc |
joebloggs | Your company name in our platform | This must be between 2 and 30 alphanumeric characters |
ekey |
88C3CF364123A25BBAB687D4FE8EC628 | Your ekey in our platform | This will be provided on set up and is available in My.txtnation.com |
class |
sg1 | The barring class of the product or service (see below) | |
ip |
169.254.62.72 | The IP address of the end user being charged | Must be a valid IP address |
transaction_id |
154289130250073169514852 | The transaction ID | |
price |
5.00 | The price of the product or service that will be charged to the end user | Must be the price in Euros to charge, including the decimal places |
description |
My cool Finland product | A short description of the product or service that is being purchased | Must be between 5 and 25 characters |
url |
http://www.txtnation.com/shop/elisa-dob-api | The URL of the product or service | Must be the URL from which the user browsing when the "Pay" button (or similar) was clicked |
product |
My first product | The name of the product or service that will appear on the bill of the end user | This should enable the end user to quickly identify the service that was purchased (max 35 characters) |
Available Classes
Telephone services have been divided into groups on the basis of their content.
- Non-profit services
- Online services
- Entertainment services
- Adult entertainment services
You should decide which class best represents your product or service and use one of the following values:
Class name | Description |
---|---|
sg1 |
Non-profit services |
sg2 |
Online services |
sg3 |
Entertainment services |
sg4 |
Adult services |
Interpreting the result
A successful call to this API will generate output similar to the following: { status: "ok", status_message: "ok", ref_id: "154289130250073169514852", msisdn: "353123456789" }
The ref_id
parameter can be used to refund the end user using a separate API call.
If the check is not successful you may receive an error similar to the following:
{ status: "error", error_code: 5000, error_message: "Missing parameter: cc" }
A full list of error codes is provided below for your reference.
Error code | HTTP code | Error description |
---|---|---|
5000 | 400 | Your request was missing a required parameter. Details of the missing parameter will be returned in the error_message . |
5001 | 400 | One (or more) of the parameters you supplied were not formatted correctly. Details of the bad parameter will be returned in the error_message . |
5002 | 403 | The credentials you supplied could not be authorised. Please check the cc and ekey parameters. |
5003 | 500 | There was an error when we passed the billing request to Sonera. |
5004 | 503 | There was an internal error with the request. Please try again later. |
5005 | 400 | The price point you requested was not available. Please contact txtNation support if you wish to use this price point. |
5006 | 503 | There was an internal error with the request. Please try again later. |
5007 | 400 | The reference ID you provided could not be matched to an original transaction. |
1022 | 400 | IP address is invalid |
1023 | 400 | IP address doesn't match temporary ticket |
1070 | 400 | Service Url field is missing or empty |
1072 | 400 | Service URL is invalid |
1080 | 400 | Description field is missing or empty |
1082 | 400 | Description is invalid |
1090 | 400 | Class field is missing or empty |
1092 | 400 | Class is invalid |
1120 | 400 | Price field is missing or empty |
1122 | 400 | Price is invalid (negative amount) |
1123 | 400 | Committed price is lower than initial one |
1124 | 400 | Committed price is higher than initial one |
1130 | 400 | Service class field is missing or empty |
1132 | 400 | Service class is invalid |
1140 | 400 | Transaction ID field is missing or empty |
1142 | 400 | Transaction ID is invalid |
1143 | 400 | Transaction is not found |
1150 | 400 | MSISDN field is missing or empty |
1152 | 400 | MSISDN is invalid |
1153 | 400 | MSISDN does not match temporary ticket |
1154 | 400 | MSISDN is restricted |
1155 | 400 | Operator code is blocked |
1156 | 400 | IMSI is restricted |
2000 | 400 | Transaction rejected due to digital profile (EstoPM) |
2001 | 400 | Transaction rejected due to sg1 barring class (EstoP1) |
2002 | 400 | Transaction rejected due to sg2 barring class (EstoP2) |
2003 | 400 | Transaction rejected due to sg3 barring class (EstoP3) |
2004 | 400 | Transaction rejected due to sg4 barring class (EstoP4) |
2005 | 400 | Max price exceeded |
3000 | 400 | Transaction rejected due to Account Information and Refill (AIR) server error |
4101 | 400 | Transaction rejected due to Varma prepaid check HTTP request error |
4102 | 400 | Transaction rejected due to Varma prepaid check I/O error |
4103 | 400 | Transaction rejected due to Varma prepaid check HTTP request status not OK |
4104 4105 124 |
400 400 400 |
Transaction rejected due to Varma prepaid check did not find MSISDN Transaction declined due transactions with MSISDN are not allowed please use the transaction ID Air server returned error , Below minimum balance |