Přejít na hlavní obsah
POST
/
bank-accounts
Vytvoriť bankový účet
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "bankId": 1,
  "autoPairingStrategy": "by_variable_symbol"
}
'
{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 23,
    "name": "Tatra Banka",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Tělo

application/json

Payload pre vytvorenie bankového účtu. Posielate iba business dáta účtu. Polia, ktoré nepošlete a majú backendový default, sa dopočítajú na strane servera.

​
name
string
povinné

Názov bankového účtu, pod ktorým ho budete identifikovať vo Fintoro.

Maximum string length: 255
Příklad:

"Hlavný účet"

​
iban
string
povinné

IBAN bankového účtu. Musí byť validný a unikátny.

Příklad:

"SK3111000000001234567890"

​
swift
string
povinné

SWIFT alebo BIC kód bankového účtu.

Maximum string length: 255
Příklad:

"TATRSKBX"

​
bankId
integer | null

Voliteľné ID banky z lookup endpointu bánk. Použite ho, ak chcete účet naviazať na konkrétnu banku z verejného lookupu.

Příklad:

1

​
autoPairingStrategy
enum<string>
výchozí:by_variable_symbol

Stratégia automatického párovania platieb pre tento účet. Ak pole nepošlete, použije sa predvolená hodnota by_variable_symbol.

Dostupné možnosti:
none,
by_variable_symbol,
by_price,
by_variable_symbol_and_price,
by_all_symbols,
by_all_symbols_and_price
Příklad:

"by_variable_symbol"

Odpověď

Bankový účet bol vytvorený.

Bankový účet. Objekt spája business údaje účtu, informáciu o banke a stav napojenia na open banking.

​
id
integer

Interné ID bankového účtu vo Fintoro.

Příklad:

201

​
bankId
integer | null

ID banky z lookup endpointu bánk. Ak je null, účet nie je naviazaný na konkrétnu banku z lookupu.

Příklad:

1

​
bank
object

Vnorený objekt banky zodpovedajúci bankId, ak je banka známa a stále dostupná v lookup datasete.

​
isPrimary
boolean

Označuje, či je tento účet aktuálne vedený ako primárny bankový účet firmy.

Příklad:

true

​
autoPaymentMatching
boolean

Označuje, či je účet aktuálne napojený na automatické párovanie platieb cez open banking. Hodnota je odvodená od existencie open banking napojenia, neposiela sa v requeste.

Příklad:

true

​
name
string

Používateľský názov bankového účtu zobrazený vo Fintoro.

Příklad:

"Hlavný účet"

​
iban
string

IBAN bankového účtu.

Příklad:

"SK3111000000001234567890"

​
swift
string

SWIFT alebo BIC kód bankového účtu.

Příklad:

"TATRSKBX"

​
autoPairingStrategy
enum<string>

Stratégia automatického párovania platieb pre tento účet.

Dostupné možnosti:
none,
by_variable_symbol,
by_price,
by_variable_symbol_and_price,
by_all_symbols,
by_all_symbols_and_price
Příklad:

"by_variable_symbol"

​
balance
number<float> | null

Posledný známy zostatok účtu, ak je dostupný z open banking napojenia.

Příklad:

1234.56

​
lastSyncedAt
string | null

Dátum a čas poslednej úspešnej synchronizácie účtu cez open banking, ak je dostupný.

Příklad:

"2026-03-01 10:15:16"

​
openBankingValidUntil
string<date> | null

Dátum, do ktorého je platný aktuálny open banking súhlas, ak existuje.

Příklad:

"2026-04-30"

​
createdAt
string | null

Dátum a čas vytvorenia bankového účtu.

Příklad:

"2026-03-03 12:00:00"

​
updatedAt
string | null

Dátum a čas poslednej zmeny bankového účtu.

Příklad:

"2026-03-03 15:45:00"