> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/b2b-2013-schema/b2b-services/b2b-credit-cards-service/fields.md).

# Fields

The following sections cover individual aspects of the service and describe how the information is presented in the messages.

## Contents of service <a href="#toc413067910" id="toc413067910"></a>

The functions available through the service plus their input and output can be seen in the following table. In the case of input and output it involves names of the classes which the service receives and produces.

<table data-full-width="true"><thead><tr><th>Function</th><th>Input</th><th>Description</th><th>Output</th></tr></thead><tbody><tr><td>GetCreditCards</td><td>Nothing</td><td>Gets overview of the user‘s credit cards.</td><td>Collection&#x3C;<a href="#_ref368573890">CreditCard</a>></td></tr><tr><td>GetCreditCard</td><td>cardId</td><td>Gets detailed information on individual credit cards</td><td><a href="#_ref368573890">CreditCard</a>-> <a href="#_ref412814967">CreditCardDetails</a></td></tr><tr><td>GetCreditCardTransactionsByDate</td><td><p>cardId, dateFrom, dateTo,</p><p>pageNumber,</p><p>pageSize</p></td><td>Gets overview of credit card transactions</td><td><p><a href="#_ref368573942">CreditCardTransactionResult</a></p><p></p></td></tr><tr><td>GetCreditCardTransactionsByDueDate</td><td><p>cardId, dueDate, pageNumber,</p><p>pageSize</p></td><td>Get transactions on credit card by due date</td><td><a href="#_ref368573942">CreditCardTransactionResult</a></td></tr><tr><td>GetCreditCardTransaction</td><td><p>cardId,</p><p>pageNumber,</p><p>pageSize</p></td><td>Gets overview of credit card transactions. It is not permitted to get all transactions at once. Instead you have to define PageSize and PageNumber.</td><td><a href="#_ref368573942">CreditCardTransactionResult</a></td></tr></tbody></table>

Amounts are not given for the functions GetCreditCards and GetCreditcard for cards in the legal collection process as collection costs are not included in the balance and could therefore give an inaccurate picture of the balance on the card. In such cases null appears in the field for amounts.

## cardId <a href="#toc413067911" id="toc413067911"></a>

Unique card number

## dateFrom, dateTo <a href="#toc413067912" id="toc413067912"></a>

Date from and date to when card transactions were performed

## dueDate <a href="#toc413067913" id="toc413067913"></a>

Month of due date. Six digits yyyymm, e.g. 201305

## pageNumber <a href="#toc413067914" id="toc413067914"></a>

Page number. Overview of transactions can be obtained in several batches.

## pageSize <a href="#toc413067915" id="toc413067915"></a>

Page size, i.e. number of transactions which appear on each page

## CreditCard <a href="#ref368573890" id="ref368573890"></a>

The class CreditCard contains basic information on credit cards and is produced as output from function GetCreditCards. Some properties are not supported, depending if the issuer is Valitor or Borgun.

<table data-full-width="true"><thead><tr><th>Úttak</th><th>Description</th><th>Valitor</th><th>Borgun</th></tr></thead><tbody><tr><td>CardOwnerName</td><td>Name of cardowner/payer</td><td>✅</td><td>✅</td></tr><tr><td>CardHolderName</td><td>Name of cardholder</td><td>✅</td><td>✅</td></tr><tr><td>CardId</td><td>Unique ID of card</td><td>✅</td><td>✅</td></tr><tr><td>CardOwnerId</td><td>Unique ID of owner/payer</td><td>✅</td><td>✅</td></tr><tr><td>CardHolderId</td><td>Unique ID of cardholder</td><td>✅</td><td>✅</td></tr><tr><td>AmountDue</td><td>Amount due/estimated to be due in ISK</td><td>✅</td><td>✅</td></tr><tr><td>Balance</td><td>Total balance on card in ISK. Can be both + and – figure. Minus figure indicates positive balance. The figure appears as null if card is in legal collection process.</td><td>✅</td><td>✅</td></tr><tr><td>Active</td><td>Is the card active or inactive? This ascertained from status codes from card companies.</td><td>✅</td><td>✅</td></tr><tr><td>LastYerTurnover</td><td>Last year’s turnover in ISK</td><td>✅</td><td>❌</td></tr><tr><td>CardType</td><td><p>Card type</p><p>e.g. purchasing card, general Arion Bank card, Platinum Arion Bank card</p></td><td>✅</td><td>✅</td></tr><tr><td>CardBrand</td><td><p>Brand:</p><p>V = Visa, M=Mastercard</p></td><td>✅</td><td>✅</td></tr><tr><td>CardRole</td><td>Main card, extra card or corporate card</td><td>✅</td><td>✅</td></tr><tr><td>BankNumber</td><td><p>Bank branch number</p><p>e.g. 0301</p></td><td>✅</td><td>✅</td></tr><tr><td>IssueDate</td><td><p>Card issue date,</p><p>e.g. 12.01.2012</p></td><td>✅</td><td>✅</td></tr><tr><td>ExpiryDate</td><td><p>Card expiry date</p><p>e.g. 31.05.2014</p></td><td>✅</td><td>✅</td></tr><tr><td>Limit</td><td><p>Credit limit+ Extra credit limit in ISK</p><p>e.g. 30,000</p></td><td>✅</td><td>✅</td></tr><tr><td>CardNumber</td><td><p>Formated card number</p><p>e.g. 4804 28** **** 0557</p></td><td>✅</td><td>✅</td></tr><tr><td>CurrentYearTurnover</td><td>Turnover in current year in ISK</td><td>✅</td><td>❌</td></tr><tr><td>DomesticUsage</td><td>Domestic withdrawals</td><td>❌</td><td>✅</td></tr><tr><td>ForeignUsage</td><td>Foreign withdrawals</td><td>❌</td><td>✅</td></tr><tr><td>AvailableBalance</td><td>Available balance in ISK</td><td>✅</td><td>❌</td></tr></tbody></table>

## CreditCardDetails <a href="#ref412814967" id="ref412814967"></a>

The class CreditCardDetails contains detailed information on credit cards and is produced as output from the function GetCreditcard.

<table data-full-width="true"><thead><tr><th>Úttak</th><th>Description</th><th>Valitor</th><th>Borgun</th></tr></thead><tbody><tr><td>AugmentedAuthorizationLimit</td><td>Increased credit limit in ISK.</td><td>✅</td><td>✅</td></tr><tr><td>AugmentedAuthorizationLimitExpiration</td><td>Expiry date of increased credit limit</td><td>✅</td><td>✅</td></tr><tr><td>AuthorizationLimit</td><td>Credit limit</td><td>✅</td><td>✅</td></tr><tr><td>AuthorizationLimitValidTo</td><td>Expiry date of credit limit</td><td>✅</td><td>❌</td></tr><tr><td>BillingStatementInDefaultNr</td><td>Number of defaults</td><td>✅</td><td>✅</td></tr><tr><td>CardPaymentDistributionLoanRemainingBalance</td><td>Remaining payments on payment distribution plan</td><td>✅</td><td>✅</td></tr><tr><td>ChargeAccount</td><td>Charge account</td><td>✅</td><td>✅</td></tr><tr><td>ChargeBranch</td><td>Branch number for charge account</td><td>✅</td><td>✅</td></tr><tr><td>ChargeLedger</td><td>Account code for charge account</td><td>✅</td><td>✅</td></tr><tr><td>CreditLimit</td><td>Credit limit. Total amount that card owner owes on all cards combined</td><td>✅</td><td>✅</td></tr><tr><td>DeclineBillingStatement</td><td>Paper free. Billing statement declined. True/false value.</td><td>✅</td><td>❌</td></tr><tr><td>DuePenaltyInterest</td><td>Due penalty interest</td><td>✅</td><td>❌</td></tr><tr><td>PenaltyInterestCurrentPeriod</td><td>Penalty interest in current period /Calculated penalty interest</td><td>✅</td><td>❌</td></tr><tr><td>IcelandairLoyaltyClub</td><td>Icelandair Loyalty Club? True/false value.</td><td>✅</td><td>❌</td></tr><tr><td>Issuer</td><td>Issuer, e.g. Valitor and Borgun</td><td>✅</td><td>✅</td></tr><tr><td>LastDueAmount</td><td>Last due amount</td><td>✅</td><td>✅</td></tr><tr><td>LastPaymentDate</td><td>Date of last deposit, e.g. 02.08.2013</td><td>✅</td><td>✅</td></tr><tr><td>LightCardInstallmentLoanRemainingBalance</td><td>Remaining light payments</td><td>✅</td><td>❌</td></tr><tr><td>MinPaymentAmount</td><td>Minimum required payment on card this month. Card companies calculate this amount. Percentage of total debt.</td><td>✅</td><td>✅</td></tr><tr><td>OlderDebtAmount</td><td>Older debt. Debt calculated on last due bill, i.e. due date reached and bill still unpaid.</td><td>✅</td><td>❌</td></tr><tr><td>PaymentDueDate</td><td>Due date, e.g. 02.08.2013</td><td>✅</td><td>✅</td></tr><tr><td>PaymentMethod</td><td>Is it "Veltikort"? True/false values</td><td>✅</td><td>✅</td></tr><tr><td>IsPrePaidBalance</td><td>Is there any credit on card? True/false values.</td><td>✅</td><td>✅</td></tr><tr><td>IsPrePaid</td><td>Is it pre-paid card or not (“Plús” card) True/false values</td><td>✅</td><td>✅</td></tr><tr><td>TransactionAmountCurrentPeriod</td><td>Transactions in current period. Total use during period</td><td>✅</td><td>✅</td></tr><tr><td>InCollection</td><td>In legal collection process. True/false values.</td><td>✅</td><td>✅</td></tr><tr><td>PenaltyInterestBase</td><td>Penalty interest base</td><td>✅</td><td>❌</td></tr><tr><td>CardTypeDescription</td><td>Card type, Kreditkort, Veltikort or Plúskort</td><td>✅</td><td>✅</td></tr><tr><td>OldestDefaultDate</td><td>The date of oldest default</td><td>✅</td><td>✅</td></tr></tbody></table>

## CreditCardTransactionResult <a href="#ref368573942" id="ref368573942"></a>

The class CreditCardTransactionResult contains information on credit card transactions. It is output from the functions GetCreditCardTransactionsByDate and GetCreditCardTransactionsByDueDate.

| **Úttak**                                           | **Lýsing**               |
| --------------------------------------------------- | ------------------------ |
| Collection<[CreditCardTransaction](#_toc413067919)> | Credit card transactions |
| [Paging](#_ref368574541)                            | Paging                   |

## CreditCardTransaction <a href="#toc413067919" id="toc413067919"></a>

The class CreditCardTransaction contains information on transactions on a credit card

<table data-full-width="true"><thead><tr><th>Úttak</th><th>Description</th><th>Valitor</th><th>Borgun</th></tr></thead><tbody><tr><td>CardId</td><td>Unique card number</td><td>✅</td><td>✅</td></tr><tr><td>TransactionID</td><td>Transaction number from systems at Borgun and Valitor</td><td>✅</td><td>✅</td></tr><tr><td>TransactionDate</td><td>Transaction date</td><td>✅</td><td>✅</td></tr><tr><td>ForeignAmount</td><td><p>Foreign amount.</p><p>This amount in country of transaction, i.e. if transaction was made in Iceland in ISK it is the same figure as in Amount.</p></td><td>✅</td><td>✅</td></tr><tr><td>Amount</td><td>Domestic amount</td><td>✅</td><td>✅</td></tr><tr><td>CurrencyCode</td><td>Currency, e.g. ISK, SEK, GBP, USD</td><td>✅</td><td>✅</td></tr><tr><td>DueDate</td><td>Due date yyyymm, e.g. 201106. In which period transaction was made.</td><td>✅</td><td>✅</td></tr><tr><td>TransactionKey</td><td>Transaction key, description e.g. fee for printed bills, money withdrawals, automatic debits</td><td>✅</td><td>✅</td></tr><tr><td>AuthorizationNumber</td><td>Authorization number.</td><td>✅</td><td>✅</td></tr><tr><td>IcelandairLoyaltyClubTransaction</td><td>Icelandair Loyalty Club Transaction e.g. 81, 187, 17, 9</td><td>✅</td><td>❌</td></tr><tr><td>IssuerBranch</td><td>Issuer branch, e.g. 0301</td><td>✅</td><td>✅</td></tr><tr><td>MerchantName</td><td>Name of merchant, e.g. SOS BARNAÞORP Skeljungur - 302 Hagkaup, Skeifan VÍNBÚÐIN HEIÐRÚN</td><td>✅</td><td>✅</td></tr><tr><td>MerchantCity</td><td>City of merchant , e.g. REYKJAVIK, KOPAVOGUR, LONDON PADDIN, TÁLKNAFJÖRÐDUR</td><td>✅</td><td>✅</td></tr><tr><td>MerchantCountryCode</td><td>Merchant country code, e.g. IS, GB, US, SE</td><td>✅</td><td>❌</td></tr><tr><td>IsEcardTransaction</td><td>e-card transaction. This data is not produced at present.</td><td>❌</td><td>❌</td></tr></tbody></table>

## Paging <a href="#ref368574541" id="ref368574541"></a>

The class Paging contains information on paging on the transaction overview

| **Úttak**    | **Lýsing**                                 |
| ------------ | ------------------------------------------ |
| TotalPages   | Total pages                                |
| TotalRecords | Total number of transactions during period |

## BankErrorFault <a href="#toc413067921" id="toc413067921"></a>

The class BankErrorFault contains information on errors which may occur when calling the service.

| Úttak            | Description                        |
| ---------------- | ---------------------------------- |
| GeneralErrorCode | General error code                 |
| GeneralErrorText | General error text                 |
| SourceErrorCode  | Source error code. Not implemented |
| SourceErrorText  | Source error text. Not implemented |
| BanksErrorCode   | Technical error code               |
| BanksErrorText   | Technical error text               |