Get access to Telekom’s P-API via VUNK to accelerate your start-up

VUNK is a pre-acceleration platform for teams who have an idea, a working prototype or even a product with traction. To help teams move faster to build their business, one of the values that VUNK provides for start-ups is access to its services via P-API. 


If you’re serious about validating your idea and building a solid business out of it, learn below about the types of services that are available in Telekom’s P-API, some examples of P-API usage and what you should do to access integration.  

What is P-API?

P-API is short for Public-API – a collection and a security layer in front of Eesti Telekom services to be used in partner applications to enrich their products and add convenience features.

What start-ups already use P-API?

There are several companies and start-ups that have build great businesses using the services available in P-API. Some examples include: Taxify, Solaris app, Piletilevi app, Piixpay, pargi.ee, Cherry (payment solution for vouchers), and many more.

What can P-API offer?

1. Authentication via voice call

What this means: We can authenticate any mobile user’s phone number and present it to Service Providers (SP). SP’s can then add it to a user profile for billing or other services.


Example:

/papi/oauth/authorize

{

  "phoneNumber":"82828318",

  "timeout":60,

  "status":"PENDING",

  "authToken":"za-A2s69_6ad4dNLVu2hD1t-sHZHtkcT",

  "created":"2015-04-29T13:23:21.248+0300”

2. Different mobile bill payment methods

- An NFC tag and/or QR code sticker

What this means:

The customer can use their mobile to complete a payment (e.g. in a cafe) and choose their favourite payment method. It also provides the option of adding other partner payment methods.






- Voice call payment

What this means:

The customer can pay using their mobile by dialling a temporary given number (e.g. news articles, ice-creams at the beach).  


- Server-side payment

What this means:

After filling a shopping kart, the SP server sends Telekom a mobile bill payment request with the customer’s hash-code or phone number

Example: cinema or concert tickets.  










3. Mobile phone positioning via carrier network

What this means: This makes it possible to request mobile positioning with default access based on the mobile numbers of your Telekom account or via a request-accept permission system.  In addition, this can be used with any device that has an active SIM card (e.g. modem, controller, etc.).

Examples: SP can obtain an overview of all numbers that are connected to an aggregated customer invoice. This service should additionally be used with internal GPS location services. This method doesn’t offer exact accuracy, but it works with any mobile device as long as there is a mobile network coverage. Plus, it doesn’t consume the user’s battery.




4. Location based triggers via carrier network

What this means: These are network-based location triggers. The mobile network operator monitors trigger rule activation. This service can be activated when: entering a defined area, leaving a defined area, two phones come close, certain defined area. For cities, the radius is 100–500 metres, outside the city the radius is 1–5 km.

Examples: If the user is in a certain area, it can trigger a message to the user’s phone with offers, etc. (user permission is needed).  





5. Roaming status, data usage and prices

What this means: User-based services in real time that make it possible to identify if the user is in roaming area, what are the roaming prices, what are the data usage limits and how much data has been used.

Example:

/papi/rest/roaming/susgInfo/<number>.json

{"emt":true,"prepaid":false,"mccMnc":"248_01f"}

/papi/rest/roaming/operators.json?emt=true&

prepaid=false&mccMnc=248_01f&countryIsoCode=FIN

[{

  "operatorCode":"244 12",

  "operatorCodeOnBill":"2G",

  "operatorName":"DNA Networks Ltd",

  "networkType":"GSM 900/1800",

  "coverageMap":"http://mobileworldlive.com/maps/netw..

/papi/rest/susgBalanceDetails/accus/msisdn/<number>.json

{"invoices":[{"accus":{"accus":[{

    "id":28,

    "name":"Roamingu shokkarve limiit",

    "amount":60,

    "balance":"60.00 €",

    "start":"2010-08-26T00:00:00.000+0300"},

    {"id":29,

      "name":"Andmesidelimiidist välismaal on kasutatud",

      "amount":0,

      "balance":"0.00 €”.



6. Mobile account balance and balance details

What this means: This provides an overview of the balance for a mobile account and the various lines on the invoice, including  usage of data, voice, messaging and other additional services on your mobile phone bill.

Example:

/papi/rest/susgBalanceDetails/msisdn/<number>.json

{"invoices":[{

  "id":"B15042087713",

  "type":"CURRENT",

  "start":"2015-04-01",

  "amount":49.07600000,

  "currency":"EUR",

  "lines":[{

    "code":"GSR",

    "description":"Interneti kasutus/täiendav mahutasu",

    "count":222,

    "duration":2930197,

    "dataVolume":800137,

    "amount":0,  



7. ACL (access control list) based remote control and management

What this means: You can control automated solutions via the Telekom P-API interface. You simply need to have an input/output controller (your own or buy one from Telekom) with a SIM card. Telekom will register that SIM+controller as yours, and then you can send output signals to that controller over the internet using our P-API. In addition, you can also manage access rights in a timely manner to manage who else can use your automated solution.

Example: You are on campus and the rules state that lab doors can only be opened with special permission from 08:00 to 16:00. Using our P-API solutions you can give students single-use tickets to open the lab doors during that timeframe.  

Are these all P-API Telekom offers?

If you have an idea or a product that needs Telekom services via P-APIs that are not listed above, you should still join the VUNK Hackathon. We take every idea and start-up case by case – if there is synergy with the Telekom business, an interesting idea with strong business potential and/or a strong team, everything is possible including a new P-API.    

What is the advantage of Telekom’s P-API for start-ups?

Integration with Telekom’s services via P-API offers considerable advantage to start-ups – imagine getting access to hundreds of thousand of paying customers who trust Telekom as a services provider and regularly pay for the services they use. How can you build your customers? – solved. How can you gain trust so customers pay you? – solved. How can you collect payments regularly? – solved. How can you make it convenient for your customers? – solved. One P-API that solves so many challenges for start-ups. And this is just one example.

How can your start-up get access to P-API?

It’s straightforward. The first and very important step is to join the VUNK Telekom Hackathon.

-       Come to VUNK hackathon, build a prototype based on your idea or contribute your skill to other teams with strong ideas. During the hackathon, actively use mentors from Telekom, Startup Wise Guys and Garage48 to create a working prototype and obtain initial validation of your idea.

-       At the end of the hackathon, the mentors will choose 5 teams/winners – these teams will be able to integrate via P-API as they build their product and business.  

During the hackathon you will access support from Telekom’s P-API guru who will help you adjust the services to suit your product.

What else do you need to know?

-       As every product is different, P-API technical integration means working with the technical team at Telekom to connect your product to Telekom’s systems. It might take around 2 weeks to finalise the technical integration.

-       To regulate the business relationship between your start-up and Telekom, a business agreement will be signed.

And last, but not least – we created listed P-API’s as a starting point for services that we see a demand for. We realise that the current list of P-API’s might not cover some great ideas. So, if you don’t see something on the list, come to the VUNK Hackathon and pitch your idea – lets build something great together.  


Starting up from inside a corporate

In addition to the two teams participating in the VUNK Accelerator programme today, quite a few teams who did not manage to set up their team during the hackathon weekend in August have independently developing their idea future.

For example Career3, a team from Eesti Telekom, was not able to find developers at a right time, but the energy of the authors of the idea has not run out – quite the opposite.

We caught up with Paul Are and Endo Viires to hear their story and see where are they heading.

Read more »

Have a pre-seed or seed stage startup?

On October 29th you have an opportunity to take a stage and have a 3-minute pitch. We'll meet at 5 p.m. @ Erinevate Tubade Klubi (Tallinn). Read more »

Two new ideas from Estonia ready to sweep the world

On Friday, the panel of VUNK accelerator mentors chose two new smart technology startups out of seven, which are seen as having potential to become international success stories.

Read more »

Meet VUNK TOP 7 team: Tippy 

In an alphabetical order get to know #GetVunked2015 team No. Seven - Tippy & team lead Marek Fraczyk. They are about to change the world of tipping & giving feedback for service you get in a bar, pub or restaurant - so no more awkward feeling when you realize the service has been superb but you cannot show it. Plus team motto - we just do it.
Read more »