Výpis transakcí provedených Fidoo kartami. 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/transaction/get-card-transactions
Lze zjistit podrobnosti o transakci jako je částka, měna, typ či stav; o kartě, kterou bylo placeno a o uživateli, který za kartou odpovídá.
Je vrácen výpis karetních transakcí provedených danou kartou či za určité období.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
cardId | Unikátní identifikátor karty v systému Fidoo. | b16d2df4-5c28-4b90-9a8a-a88c3258fa53 |
from | Počáteční datum pro filtrování karetních transakcí. Uveden ve formátu ISO 8601. | 2023-04-01T01:00:00Z |
to | Konečné datum pro filtrování karetních transakcí. Uveden ve formátu ISO 8601. | 2023-04-30T23:59:99Z |
includeHeldTransactions | Indikátor možnosti budoucích změn na transakcích. Hodnoty: true = vrácení všech transakcí, i pozdržených nezaúčtovaných (mohou se ještě změnit); false = vrácení všech zaúčtovaných transakcí. | 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 |
transactionList | Výpis karetních transakcí. | – |
· id | Unikátní identifikátor karetní transakce v systému Fidoo. | 07dcca40-9858-4139-9230-bb86d97cf64e |
· cardId | Unikátní identifikátor karty v systému Fidoo. | b16d2df4-5c28-4b90-9a8a-a88c3258fa53 |
· expenseId | Unikátní identifikátor výdaje v systému Fidoo. | r6417d750-2f6a-11e9-b210-d663bd873d93 |
· cardEmbossName | Vyražené pojmenování karty. Když cardType=personal, pak je vráceno: jméno držitele karty. Když cardType=shared, pak je vrácen: název karty. | TYM OMEGA |
· cardMaskedNumber | Maskovaný PAN karty. | 549546******3575 |
· transactionDate | Časové razítko vytvoření karetní transakce. Uvedeno ve formátu ISO 8601. | 2023-08-24T22:00:00Z |
· settlementDate | Časové razítko zaúčtování karetní transakce. Uvedeno ve formátu ISO 8601. | 2023-08-24T22:00:00Z |
· originalAmount | Částka transakce. Uvedená v měně CZK (Korunách českých). | 450 |
· originalCurrency | Měna transakce. Uvedena ve formátu ISO 4217. | CZK |
· signedAmount | Zaúčtovaná částka. Pokud je již zaúčtováno. Uvedená v měně CZK. | -11745,14 |
· serviceFee | Výše servisního poplatku. | 0 |
· transactionStatus | Stav karetní transakce. Hodnoty: accounted = Zaúčtovaná transakce; blocked = Blokovaná transakce; denied = Zamítnutá transakce; expired = Uvolněná blokace. | accounted |
· transactionType | Typ karetní transakce. Hodnoty: merchant = Platba u obchodníka (Platby v CZK, Platby v cizí měně); load = Dobití karty; unload = Vybití karty, Převod zpět na Fidoo účet; withdrawal = Výběry z bankomatů v CZK, Výběry z bankomatů v cizí měně; refund = Vratka od obchodníka, Vratky od obchodníků; balance-adjustment = Opravná transakce. | load |
· merchantName | Název obchodníka. | CESKE DRAHY, A.S. |
· merchantLocation | Adresa (město) obchodníka. | PRAHA 1 |
· merchantCountry | Identifikátor země, na jejímž území k transakci došlo. | CZ |
· categoryName | Kategorie obchodníka. Hodnoty: beauty = Krása; bills-and-household = Domácnost; car = Auto; children = Děti; consumer-goods = Spotřební zboží; culture = Kultura; digital-services = Digitální služby; drugstore = Drogerie; electronics = Elektronika; fashion = Móda; financial-services = Finanční služby; food-and-drink = Stravování; freetime = Zábava; groceries = Potraviny; health = Zdraví; house-and-garden = Dům a zahrada; pets = Mazlíčci; professional-services = Služby; shopping-online = Nakupování na internetu; sport = Sport; travel = Cestování; other = Ostatní. | travel |
· cardType | Typ karty. Hodnoty: personal = karta je osobní; shared = karta je týmová. | shared |
· mcc | Mezinárodní kód kategorie obchodníka. čtyřčíselný Merchant Category Code. | 4722 |
· transactionLocalDateTime | Časové razítko transakce v místním čase. Uvedeno ve formátu ISO 8601. | 2023-08-24T22:00:00.000Z |
· 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ý?