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.  


Tackling SmartCities and Digitalization

IoT for Telia has become the cornerstone for innovation. It is now time transform it into a more concrete framework, where there are more opportunities for partnerships. At VUNK, we look for companies offering state-of-the-art IoT services, are intelligently tackling SmartCity problems and offering value to their SME and B2B clients.
Read more »

Empowering wellness

Technology today allows us to track our activities, sleeping hours, nutrition intake, as well as, monitoring of other vital attributes. But data without context and knowledge is worthless. The question is, how can we use this personally or collectively generated data to achieve greater good?
Read more »

The Ultimate Accelerator Pivot To Collaboration Framework

Helping start-up and business entrepreneurs in the last two years, Vunk has become the most sought-after entry point to telecom sector for innovative B2B and B2C start-ups in the region. Vunk was launched in 2015 as a start-up itself that worked with many aspiring startup founders, partners, mentors and helped them accelerate their businesses to new heights. It devised new ways of working and implemented effective strategies that helped business grow at a steady pace.

Read more »

Vunk ja Partnerlus.

Pikemalt nüüd ka meie uuest üleskutsest, kuhu erinevalt eelmistest aastatest ootame juba töötava äriideega start-uppe. Meie ülimaks eesmärgiks on luua partnerlusi, et ühiselt innovaatilisi ideid edasi arendada ja pakkuda kliendile uut väärtust.
Read more »

Older articles