Přejít na hlavní obsah
PATCH
/
bank-accounts
/
{bankAccount}
Upraviť bankový účet
curl --request PATCH \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bankId": 1,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_price",
  "isPrimary": true
}
'
{
  "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.

Parametry cesty

​
bankAccount
integer
povinné

ID bankového účtu.

Příklad:

201

Tělo

application/json

Payload pre aktualizáciu bankového účtu. Pošlite len polia, ktoré chcete zmeniť. Polia, ktoré vynecháte, zostanú bez zmeny.

​
bankId
integer | null

Voliteľné ID banky z lookup endpointu bánk. Pošlite null, ak chcete väzbu na banku odstrániť.

Příklad:

1

​
name
string

Nový názov bankového účtu.

Maximum string length: 255
Příklad:

"Hlavný účet"

​
iban
string

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

Příklad:

"SK3111000000001234567890"

​
swift
string

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

Maximum string length: 255
Příklad:

"TATRSKBX"

​
autoPairingStrategy
enum<string>

Nová stratégia automatického párovania platieb pre tento účet. Ak pole vynecháte, zostane zachovaná existujúca hodnota.

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_price"

​
isPrimary
boolean

Pošlite true, ak chcete účet nastaviť ako primárny účet firmy. Ak pole vynecháte alebo pošlete false, aktuálne priradenie primárneho účtu zostane bez zmeny a účet sa touto operáciou neprepne na neprimárny.

Příklad:

true

Odpověď

Bankový účet bol aktualizovaný.

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"