CardAccountDetails Data Type

Card account details.

Properties
name data type constraints description
resourceId string   This is the data element to be used in the path when retrieving data from a dedicated account. This shall be filled, if addressable resource are created by the ASPSP on the /card-accounts endpoint.
maskedPan string required, max size: 35, min size: 0 Masked Primary Account Number
currency string required, regex: [A-Z]{3} ISO 4217 Alpha 3 currency code.
ownerName string max size: 140, min size: 0

Name of the legal account owner. If there is more than one owner, then e.g. two names might be noted here.

For a corporate account, the corporate name is used for this attribute. Even if supported by the ASPSP, the provision of this field might depend on the fact whether an explicit consent to this specific additional account information has been given by the PSU.

name string max size: 70, min size: 0 Name of the account, as assigned by the ASPSP, in agreement with the account owner in order to provide an additional means of identification of the account.
displayName string max size: 70, min size: 0 Name of the account as defined by the PSU within online channels.
product string max size: 35, min size: 0 Product Name of the Bank for this account, proprietary definition.
status AccountStatus   Account status.
usage Usage   Specifies the usage of the account
details string max size: 500, min size: 0

Specifications that might be provided by the ASPSP

  • characteristics of the account
  • characteristics of the relevant card
creditLimit Amount   The card limit.
balances array of Balance   A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.
_links LinksAccountDetails  

Links to the account, which can be directly used for retrieving account information from this dedicated account.

Links to "balances" and/or "transactions"

These links are only supported, when the corresponding consent has been already granted.

Example

{
  "resourceId" : "...",
  "maskedPan" : "123456xxxxxx1234",
  "currency" : "EUR",
  "ownerName" : "John Doe",
  "name" : "...",
  "displayName" : "...",
  "product" : "...",
  "status" : "deleted",
  "usage" : "PRIV",
  "details" : "...",
  "creditLimit" : {
    "amount" : 5877.78,
    "currency" : "EUR"
  },
  "balances" : [ {
    "balanceAmount" : {
      "amount" : 5877.78,
      "currency" : "EUR"
    },
    "balanceType" : "expected",
    "creditLimitIncluded" : true,
    "lastChangeDateTime" : 12345,
    "referenceDate" : "...",
    "lastCommittedTransaction" : "..."
  }, {
    "balanceAmount" : {
      "amount" : 12345.0,
      "currency" : "..."
    },
    "balanceType" : "expected",
    "creditLimitIncluded" : true,
    "lastChangeDateTime" : 12345,
    "referenceDate" : "...",
    "lastCommittedTransaction" : "..."
  } ],
  "_links" : {
    "balances" : {
      "href" : "/v1/payments/sepa-credit-transfers/1234-wertiq-983"
    },
    "transactions" : {
      "href" : "/v1/payments/sepa-credit-transfers/1234-wertiq-983"
    }
  }
}