How to Start?

You can take your first step into the FinTech world using ininal API Developer Portal.

The purpose of this document is to explain how to access ininal APIs and explain what can be build with it. This document contains both functional and technical information on ininal APIs.

Developers can develop projects that includes basic financial features using ininal API services such as user creation, virtual card creation, assigning card to user, and money transfer. The first thing you need to do to be able to use ininal API services is to register to ininal Developer Portal.


To register, all you have to do is fill out the form on the Registration page.

Once you complete the registration process, you will be directed to the page where you will access APIKEY and SECRETKEY . By using this information, you will have access to ininal API services.

API Usage##

Access to the Services

In order to use ininal API services, first of all you must register to ininal Developer Portal and obtain API and Secret Key information. You will have to use this information to access Acces Token by accessing the Authentication service.

Access Tokens that are custom generated and expire after a certain period of time will provide security measures to you and your users for each request that you make to ininal API services.

User Operations

In order to perform user operations using ininal APIs, each user needs to have a unique ininal account. Turkish Republic ID number of your users during the user registration process is also verified through identity validation service.

The user's unique user-token generated by the system after the user registration process will be used for user identification and future operations on ininal ecosystem.

Card Operations

After creating an ininal account, you must first add this card to your user's account by creating a virtual card or ordering a physical card.

At ininal systems, individual card-token information is generated by the system after card assignment. Card-token will be used at all services that are using card-token to operate. You can load balance to ininal cards that you are added to any user account, instantly get card transactions and balance info, and you can use all services that needs card-token.

An ininal card that is not assigned to an ininal account can be only loaded once.

Done! :)

Now you can access to ininal API services, create user accounts and also use all card services to develop your project.

API Requests##

You can use REST client tools ( like Postman, Advanced REST client, etc. ) to test ininal APIs.

Authorization Structure##

First of all, AccessToken must be obtained through the Authorization service in order to access ininal API services.

ininal API uses the OAuth 2.0 protocol. All API calls must be made with SSL. ( https:// )


OAuth 2.0

OAuth 2.0 is an open authorization protocol that allows applications to access data between each other. OAuth is a protocol for application authorization, not for user authentication.

Developer must first encode APIKEY and SECRETKEY with base64.

Encoded data should be created with the format "{ APIKEY }":"{ SECRETKEY }". Encoding service that provided at link can be used for encoding.


Encoded token should be add as "Basic {token}" format. Access Token service should be used to generate accessToken.



Access Token will be expire in 60 minutes, you need to re-create another Access Token when it expires.

    “httpCode”: 200,
    “description”: “OK”,
    “response”: {
        “tokenType”: “Bearer”,
        “expiresIn”: 3600000
    “validationErrors”: null

The accessToken obtained using the Two-Leg Authentication structure is used in all other API calls.

API Call via accessToken

The first step after accessToken is generated, will be to create a user with the Create User service from the Users services.

Then you can assign a card using userToken, which will return for each added user, with the service Card Assign.

"name": "Ahmet",
"surname": "Ozperson",
"email": "[email protected]",
"gsmNumber": "5500000000",
"tcIdentificationNumber": "12317712317",
"password": "890qwe890",
"birthDate": "01-01-1990",
"motherMaidenName": "Örnek"

If you need help while reviewing ininal APIs, you can contact us at [email protected]