# Альфа-Банк Бизнес

See turnover and account transactions from Alfa-Bank in chat

Банковский API — счета, выписки, операции, платежи

## How the agent works with Альфа-Банк Бизнес

The agent calls the Alfa-Business API at baas.alfabank.ru and starts from the list of company accounts — the same request that verifies the connection. From there it pulls the statement for the selected accounts over a period, totals incoming and outgoing turnover, surfaces large and unusual transactions and breaks payments and receipts down by counterparty and purpose, so the weekly summary comes together without a manual export from the internet bank.

A bank statement is not the same thing as what is happening on the account right now: it carries the transactions the bank has already posted, so a fresh payment or credit appears in it later than the company learns about it. The agent works from the posting date rather than the moment the payment became known, and when reconciling against 1C entries it matches transactions by amount, date and counterparty details rather than by the payment purpose alone.

By default the agent reads: accounts, statements, transaction history, reconciliation with the books and recurring summaries. The payment part of the API is available, but signing an order stays on the bank's side and goes through confirmation in Alfa-Business Online — the agent cannot send money silently. Before any write action it shows the details and the amount it has assembled and stops until you confirm them.

Access has two layers: the API key travels as a token, while some methods additionally require a client certificate, so the set of available operations depends on which layer is open. The statement comes back in pages and with a cap on the length of the period, so the agent collects long intervals in chunks and stitches them together itself, holding the request rate. If there is no data for the period or the key lacks permissions, it says so directly instead of showing an empty table.

## Integration scenarios

### Transactions and balances for any period
The agent pulls the statement across your Alfa-Business accounts, totals turnover and flags large or unusual transactions.

### Reconciliation with accounting
The agent matches bank transactions against 1C entries and shows which payments never made it into the books.

### Weekly financial digest
On a schedule, the agent assembles balance dynamics, top payments and the week's incoming funds into a single report.

### Breakdown by counterparty
The agent splits receipts and payments by counterparty and purpose and shows who brought in the most money and where it drained away.

### A payment before it leaves
The agent assembles the order's details and amount, lays them out in one list and stops — the signature stays with you in Alfa-Business Online.

### Where the quarter's money went
The agent pulls a long statement period in chunks, stitches it together itself and shows the spending structure and how turnover moved month to month.

## How to connect

**Before you connect**

- A settlement account and cash management at Alfa-Bank
- A director or an employee with signing authority
- OpenSSL installed to generate the private key

### Check your account and Alfa-Business Online
Alfa API is granted to companies with a settlement account, cash management and Alfa-Business Online (Альфа-Бизнес Онлайн) enabled. There is no connection fee.

### Request access and sign the ITV agreement
Email alfa_api@alfabank.ru with your company details. Sign the ITV agreement in Alfa-Business Online; the bank then issues your Client ID.

### Generate the CSR and get the certificate
Run openssl req -new -key name.key -out name.csr with your company details. The bank returns a PEM certificate; name.key never leaves you.

## FAQ

### What do I need to connect Alfa-Bank?
An API key from Alfa-Business Online and, for some methods, a client certificate. Everything is stored encrypted.

### What data does the agent read?
Company accounts, statements, transactions and payments, within the permissions of the key. Data is requested at the moment of the task, with no permanent export.

### Can access be revoked?
Yes, in one click: delete the connection on our side or revoke the key in Alfa-Business Online, and access stops immediately.

[Open Альфа-Банк Бизнес](https://developers.alfabank.ru/products/alfa-api)