Bank Accounts
Bank Accounts lets you connect your business's own bank accounts to Lunixi and read their account list, balances and transactions (statement lines) in one place. You can view the data in the panel, read it from your own server with your API key, and receive new transactions by webhook.
What it offers
| Capability | Description |
|---|---|
| Account list | The accounts at your connected banks; IBAN and account number are returned masked. |
| Balance | The most recently read balance of each account. |
| Transactions | Incoming and outgoing transactions, with a bank-independent common transaction type (canonicalType). |
| New transaction notification | A bank_account.transaction.received webhook event for every newly read transaction. |
| Freshness | When the data was last read and when the next read is possible. |
| Panel screens | Your connected banks, your total assets per currency, and accounts and transactions in the bank details. |
| Account statement | Download the transactions you filtered as an Excel or PDF statement from the panel. |
| Money transfers | If your connection supports transfers, send money from your connected account to an IBAN, in the panel or through the API. → Money Transfers |
| Currency exchange | If your connection supports it, buy and sell currency between two of your accounts at the same bank. → Currency Exchange |
| Transfer notification | bank_transfer.* webhook events when a transfer is created and settled. |
Money transfers and currency exchange are not available on every connection. Read what your connection supports from the connection's capabilities field. → Connections
What it does not offer
- You cannot connect a bank through the API; connecting is done only in the panel.
- You cannot change your bank account's settings, limits or signatories.
- You cannot send money from connections that do not support transfers; on those connections the product only reads.
How it works
Connect your bank in the panel
In the panel, open Banka Bağlantıları › Entegrasyonlar (Bank Connections › Integrations), pick your bank and click Connect with Lunixi. If the bank requires application documents, you deliver the wet-signed application to your branch; once your bank sends you the API details, you enter them in the connection details and Lunixi completes the setup. Banks you can connect: Banks › Supported banks. → Connect a Bank in the Panel
Grant your API key access
Your key must carry the Bank Connections product (BANK_CONNECT) and the bank-connect:view permission. To read balances and transactions, also add bank-connect:transactions:view. To send transfers or exchange currency through the API you need bank-connect:transfer; it is given only to a key with an IP allowlist. → API Introduction
Read and subscribe
Read accounts, balances and transactions from the API, and subscribe to the webhook event for new transactions. → Accounts · Transactions · Webhook Events
You cannot connect a bank through the API. Connecting is done only in the panel. Your bank details and application documents never pass through your server. Your API key reads data; a key with the bank-connect:transfer permission and an IP allowlist can also send transfers and exchange currency.
Screens in the panel
Once the connection is active, you see your data in the panel under Banka Bağlantıları (Bank Connections):
| Screen | What it shows |
|---|---|
| Bankalar (Banks) | Total cards per currency at the top (e.g. All TRY assets · 4 accounts · amount); below them a card for each connected bank: balances per currency, number of accounts and time of the last update. |
| Bank details | Opens when you click a bank on the Banks screen. On the left, totals per currency and account selection; on the right, transactions, filters, transaction details and Refresh now. |
| Account statement | Excel or PDF from the bank details; all transactions matching the filters, at most 10,000 transactions. |
| Entegrasyonlar (Integrations) | Where you pick a bank and start a connection or an application. |
| Hesaplar (Accounts) and Hareketler (Transactions) | The accounts and transactions at all your banks in one list. |
| Para gönder (Send money) and Döviz çevir (Exchange currency) | Transfers and currency exchange at banks whose connection supports them; confirmed with an e-mail verification code. |
Details: Banks and Statements