Výpis transakcí na Fidoo účtu a výpis připojených bankovních účtů. Prostředí, klíč v hlavičce X-Api-Key, stránkování a čtení tabulek popisuje Public API – základy. Dokumentace odpovídá stavu API k 6. 8. 2026.
POST /v2/accounts/get-accounts
Umožňuje zjistit náležitosti připojeného firemního účtu.
Je voláno pouze s headers bez body.
Je vráceno číslo, měna, zůstatky a blokace hlavního firemního účtu připojeného k Fidoo účtu.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
accounts | Výpis dílčích bankovních účtů. | – |
· bankAccountNumber | Výpis náležitostí bankovního účtu. | – |
·· prefix | Předčíslí bankovního účtu (první část). | 19 |
·· base | Číslo bankovního účtu (druhá část). | 123457 |
·· bankCode | Kód banky. | 0100 |
· currency | Měna. Uvedena ve formátu ISO 4217. | CZK |
· totalBalance | Celkový zůstatek. | 100000 |
· availableBalance | Zůstatek na účtu. | 100 |
· cardsAvailableBalance | Zůstatek na kartách. | 100 |
· cardsBlockedBalance | Blokace na kartách. | 5500 |
POST /v2/mvc-transaction/get-transactions
Umožňuje zjistit podobnosti o transakcích na Fidoo (MVC) účtu, které podléhají volaným filtrům.
Jsou vráceny všechny transakce Fidoo (MVC) účtu včetně poplatků s vazbou na uživatele, kteří tvoří daný poplatek v daném měsíci.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
fromDate | Počáteční datum pro filtrování výdajů. Uveden ve formátu ISO 8601. | 2024-01-15T08:59:37.239462+01:00 |
toDate | Konečné datum pro filtrování výdajů. Uveden ve formátu ISO 8601. | 2024-06-15T19:59:37.239462+01:00 |
onlyFees | Indikátor, zda je transakce poplatkem. Hodnoty: true = vrácení pouze transakcí, co jsou poplatky; false = vrácení pouze transakcí, co nejsou poplatky. | false |
addFeeUsers | Možnost výpisu uživatelů k jednotlivým poplatkům. Hodnoty: true = bude vypsán seznam uživatelů k transakcím, které jsou poplatky; false = nebude vypsán seznam uživatelů k transakcím, které jsou poplatky. | false |
limit | Maximální počet vrácených řádků (karet). Výchozí hodnota je 100. | 100 |
offsetToken | Klíč pro vícenásobné volání. Uveden jako hodnota parametru nextOffsetToken vraceného do nabytí stavu "complete": true. | T101 |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
complete | Stav dokončení kompletního výpisu. Hodnoty: true = výpis je kompletní (dokončen); false = výpis není kompletní. | false |
nextOffsetToken | Klíč pro vícenásobné volání. | T101 |
mvcTransactionResponseList | Výpis transakcí na Fidoo účtu. | – |
· transactionId | Unikátní identifikátor transakce na Fidoo účtu v systému Fidoo. | 30dcca40-9858-4139-9230-bb86d97cf64e |
· transactionCreateDate | Časové razítko vytvoření transakce. | 2024-02-15T09:38:59Z |
· transactionType | Typ transakce či poplatku na Fidoo účtu. Hodnoty: balance-adjustment = Opravné transakce; card-creation-fee = Poplatek za výrobu Fidoo karty; card-load = Dobití prostředků na karty; card-unload = Vybití prostředků z karet na Fidoo účet; card-renewal-fee = Poplatek za obnovu Fidoo karty; fee-balance-adjustment = Vratka/Bonus; insurance-fee = Poplatek za cestovní pojištění; monthly-service-fee = Poplatek za vedení Fidoo karty; mvc-load = Převody na Fidoo účet; mvc-unload = Převody z Fidoo účtu; online-account-fee = Poplatek za služby Fidoo; orlen-fuel-bonus = Úspory za tankování v síti ORLEN; other = Ostatní poplatky; atm-fee = Poplatek za výběr z bankomatu (stav již vyřazen). | mvc-load |
· transactionOriginalAmount | Původní částka transakce. | 1000.00000 |
· transactionOriginalCurrency | Původní měna transakce. | CZK |
· transactionSettledAmount | Zaúčtovaná částka transakce (pokud již bylo zaúčtováno). | -1000.00 |
· transactionSettlementDate | Datum zaúčtování transakce (pokud již bylo zaúčtováno). | 2024-02-16T09:38:59Z |
· cardId | Unikátní identifikátor karty v systému Fidoo. | b16d2df4-5c28-4b90-9a8a-a88c3258fa53 |
· cardMaskedNumber | Maskovaný PAN karty. | 549546******3575 |
· cardEmbossName | Jméno uživatele či název vyražený na kartě. | JAN NOVAK |
· transactionInitiatedUserEmail | E-mail uživatele, který transakci inicioval. | jan.novak@fidoo.com |
· transactionInitiatedUserName | Jméno a příjmení uživatele, který transakci inicioval. | Jan Novák |
· transactionNote | Poznámka k transakci na Fidoo účtu. | Nahraní peněz na účet |
· clientAccountNumber | Číslo protiúčtu, ze kterého byl stav Fidoo účet navýšen nebo snížen. | 21312312312/1234 |
· variableSymbol | Variabilní symbol transakce. | 123456 |
· specificSymbol | Specifický symbol transakce. | 123456 |
· isFee | Indikátor, zda je transakce poplatkem. Hodnoty: true = jedná se o poplatek; false = nejedná se o poplatek. | false |
· feeUsers | Výpis seznamu uživatelů s vazbou na poplatek. | – |
·· userId | Unikátní identifikátor uživatele v systému Fidoo. | 0cf6e5c1-3c77-4383-9a86-6fef12d9f62b |
·· employeeNumber | Zaměstnanecké číslo uživatele. | AX12545 |
Byl tento článek užitečný?