booked: refers to the sum of
bookedtransactions, meaning already debited or credited.
pending: refers to
pendingtransactions, meaning those that were authorized but have not yet been debited.
available: refers to the sum of
pendingbalances. This is the available balance that can actually be spent.
bookedtransactions: these are debit or credit transactions that are completed and have already been recorded. These are the lines on the account statement.
pendingtransactions: these transactions were already authorized but have not yet been recorded. This type of transaction is commonly used to help the customer to understand their available balance, indicating the balance that is actually available to be sent on this account.
rejectedtransactions: these transactions were rejected. Since our accounts are designed not to carry a credit balance, this type of transaction is commonly used to help the customer understand why a transaction was refused (for example for insufficient funds).
upcomingtransactions: these transactions have not yet been authorized and will soon be executed (for example SEPA Direct Debit).
canceledtransactions: these transactions were canceled. For example, when the account holder cancel an upcoming SEPA Direct Debit.
releasedtransactions: these transactions were released. These are card transactions when the authorization is expired, the available balance that has not been debited is free from the available account balance.
accountobject returns a
requiredConsentToFetchNewTransactionsattribute. Redirecting the user to the
consentURLwill trigger Swan's Strong Authentication to push a text message on the user's phone. Learn More.
consentIdin query params and you can call this query again to read the transaction list of any account.
typefield describes which one has occured :
SepaCreditTransferOut: When a SEPA Credit Transfer debited the account.
SepaCreditTransferOutReturn: When a previous SEPA Credit Transfer debited the account and the creditor returned it.
SepaCreditTransferOutRecall: When a previous SEPA Credit Transfer debited the account and the account holder recalled the transfer and the creditor accepted.
SepaCreditTransferIn: When a SEPA Credit Transfer credited the account.
SepaCreditTransferInReturn: When a previous SEPA Credit Transfer credited the account and the account holder returned it.
SepaCreditTransferInRecall: When a previous SEPA Credit Transfer credited the account and the debtor recalled the transfer and the account holder accepted.
Fees: When Swan debited fees on the account.
SepaDirectDebitOut: When a SEPA Direct Debit debited the account.
SepaDirectDebitOutRefund: When a previous SEPA Direct Debit debited the account and the account holder refused it.
TopUpCardIn: When an e-commerce card payment credited the account.
TopUpCardRefund: When a previous e-commerce card top-up credited the account and Swan refunded the transaction.
TopUpCardChargeback: When a previous e-commerce card top-up credited the account and Swan received a chargeback.
partnershipStatusInfoon each account.
Cancelingstatus and will provide the exact date of the end of the partnership in the
canceledAfterfield. At the end of this period, the
Canceledstatus and you will no longer be able to access the account number nor the account holder's identifying information.
Canceledstatus; all access to the balance, transactions, and other account information will be immediately cut-off. You will no longer have access to the account number.
closeAccountmutation with their user token. Swan will then ask for the user's consent, and a consent resource will be returned containing the
consentUrlwhich will let you redirect the user to launch Swan's strong authentication process. Learn More.
Closinguntil the booked balance is at zero, the last SDD was more than 30 days ago and the last SCT more than 5 working days ago. As soon as an account has
Closed. After closing, account access and account statements remain available for one year either through our #nocode interfaces or via the API.