Skip to content

Card API Level 2

Susanne-glitch edited this page Apr 12, 2026 · 15 revisions

Model

Card-API_Level2

“cards” resource

The term “cards” refers to both physical and virtual credit or debit cards issued by banks or financial institutions. Physical cards are the traditional plastic cards that holders carry with them. Virtual cards, on the other hand, only exist in digital form and are often used for online payments. These virtual cards have a card number, expiration date and security code like physical cards.

“card-tokens” resource

The term “card tokens” refers to the DPAN (Digital Primary Account Number) of a credit or debit card that is stored in digital wallets, wearables or with merchants (e.g. for click-to-pay). The “card token” serves as a replacement for the PAN and is used for transactions instead of the real card number. This reduces the risk of data misuse or fraud, as the sensitive card data is not transmitted directly.

“transactions” resource

The term “transactions” refers to payments made with physical or virtual cards or with card tokens. These transactions are displayed on the cardholder's account and include all authorized and recorded payments entered by the cardholder. Transactions can include various types of payments, such as retail purchases, online payments, transfers between accounts, etc. Each transaction undergoes authorization and clearing, meaning it has been approved by the cardholder and the payment amount has been debited from the cardholder's account. At present, only financially relevant transactions are within scope. Declined authorizations and non-financial authorizations may be included at a later stage if the need arises.

“card-accounts” resource

tbd

“person” resource

tbd

“statements” resource

tbd

“card-contracts” resource

tbd

“card-accountbundles” resource

tbd

Use Cases

Identifier Description
PFM/BFM Everything from level 1, plus consideration of account-based transactions.
Card overview Everything from level 1, plus more extensive information on card account data.

Remarks

none so far

Clone this wiki locally