Skip to main content
POST
Vytvoriť bankový účet

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 | null

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"