Documentation Changelog

13.01.2023

• Added a new field currencies to the Allowed Accounts Object

19.12.2022

• Updated description for the CONSENT.RESOURCE_NOT_GRANTED consent error
• Moved accounts_group_id from response to request in Insights-Refresh

07.12.2022

• Added the new consent error CONSENT.RESOURCE_NOT_GRANTED

24.10.2022

• Added the purpose_code to the transaction-object
• Added the purpose_code to the request of the transfer flow.
• Added the adjusted_purpose_code to the response of the transfer flow.

12.10.2022

• Added the references unstructured, structured, message, opposing_message and end_to_end to the transfer flow Transfer Flow

04.10.2022

• Added Similar Transactions Report

28.09.2022

• Added the Klarna Branded feature accounts_selection to the Accounts Flow

01.09.2022

• Changed our ENUM data-type documentation regards adding new enum values is not breaking

29.08.2022

• Added the accounts_group_id to insights accounts and refresh calls.

17.08.2022

• Added bank_krn, integration_krn and sub_integration_krn to bank object in session_get response

16.08.2022

• Added transfer_method in response for a successful Transfer Flow
• Added prefill.organization_registration_ids in Create session request
• Added prefill & prefill.organization_registration_ids in Get session request
• Added InputFormElement#data_type.ORGANIZATION_REGISTRATION_ID in Input Element

15.08.2022

• Added upsert and delete labels endpoints for Storage accounts

08.08.2022

• Added the references message, opposing_message, mandate, additional_information and national to the response calls of a transaction call

03.08.2022

• Added the Balance Prediction Report

20.07.2022

• Added the merchant_category_code description to the request and response calls of a transfer call

13.07.2022

• Added the merchant_category_code description to the response of the transactions flow and consent endpoint call.

29.06.2022

• Added the category_ids parameter to the Expense Category Report.

20.06.2022

• Added auth_url to redirect/start response

18.05.2022

• Added redirect/start endpoint documentation

17.05.2022

• Added labels as a parameter to the Create accounts, to the List accounts and to the Account Info Report.

11.05.2022

• Added allowed_accounts object to insights-refresh and consent-refresh

09.05.2022

• Added preferred_pagination_size as a parameter for transactions flow and consent transactions call
• Added pagination object
• Added sub item Paginate Transactions to transactions flow and consent transactions
• Added Paginate Transactions page detailing pagination endpoint for flows and consent

12.04.2022

• Added account_number as a parameter to the selected_accounts of the start of the insights-refresh

22.03.2022

• Added account_number as a parameter to start any Flow

18.03.2022

• Added response field bank_name to the Account Info Report.
• Fixed typo insights_consumer_id from being optional to being required in List accounts Report.

09.03.2022

• Added new value CONSUMER_MULTI_SELECTED_ADD_ONLY_NEW to enum type in RefreshFlowAccounts

07.03.2022

• Added new field appearenceMode and skipInitialLoader to XS2A App configuration.

21.02.2022

• Added fetch and update transactions guide for integration.
• Added fetch account data guide for integration.

17.02.2022

• Added the account_ids field to the AllowedAccount object
• Amended datetime formats and examples

08.02.2022

• Added the capabilities field to the Account object

03.02.2022

• Added the consent_authorization_required response field and some missing documentation about existing response fields to the Auto-refresh Get Status Report.

26.01.2022

• Added the consent_expected_expiry_date response field to the Account info Report.

21.01.2022

• Added the refresh_interval parameter to the Schedule an automatic and Get the status of a scheduled Insights-Refresh.

20.01.2022

• Amended the headers of the Consent Insights Refresh call.

17.01.2022

• Added the required_data_availability parameter to the Balances report.

12.01.2022

• Added the combine_accounts parameter to the Categorized transactions and Expense-by-Category report.

08.12.2021

• Added the excluded_labels parameter to the categorization and expense-by-category report.
• Added the labels parameter expense-by-category report.

06.12.2021

• Added Latvia (LV) as supported country (currently in development).
• Poland (PL) is now fully available.
• Added consent lifetime zero case.
• added original amount to transactions object in documentation.

30.11.2021

• Removes overlap form element.

19.11.2021

• Added data availability parameters to the following reports: Categorized transactions, Expense Category, Recurring transactions.

17.11.2021

• Added from/to dates in consent insights refresh response.

16.11.2021

• Added from/to dates in flow-insights response.

15.11.2021

• Added note the flow-insights from/to date parameters.

05.11.2021

• Improved the insights quick start documentation.

03.11.2021

• Added a new response field oldest_transaction_date in Account info Report.

02.11.2021

• Added new field order in Expense Category.

28.10.2021

• Added a new field excluded_categories in Expense Category Report.

25.10.2021

• Added the link form element to XS2A-Form See the change announcement for more details.

22.10.2021

• Added the DEBIT_AND_ZERO value to the transaction_type field in Categorized transactions.

19.10.2021

• Added the labels field in Categorized transactions. It can be used to filter the report to only contain transactions that have at least one of the requested labels, matched by both key and value.
• Added a new field client_correlation_id as part of the session create request.

14.10.2021

• Added the states field in the Expense Category Report, Added only_main_category field in the Categorized Transactions Report.

14.10.2021

• Renamed all occurrences for our domain api.playground.openbanking.klarna.com to api.openbanking.playground.klarna.com. The old domain is still working but deprecated.

23.09.2021

• Added a transfer-state endpoint that can be used to fetch an updated transfer state for PSD2 integrations. Additionally, the result of a transfer response were updated.

08.09.2021

• Added data_type field to InputFormElement.

02.09.2021

• Added new fields transfer_state and bank_transfer_state to result of a Transfer Flow.
• Added german language to Italy

01.09.2021

• Added data structure around report responses.

25.08.2021

• Added category fields to the Storage Transaction Object.

21.07.2021

• Added new order type, new state and transaction type filter for the categorize transaction report and list endpoint.

14.07.2021

• Amended description for schedule automatic refresh calls.
• corrected type in CategorizedTransactionReport response description.

29.06.2021

• Added information on how to retrieve crucial flow information after a redirect.

18.06.2021

• Added description for Bulk reports.
• Marked modular report generation deprecated.

18.05.2021

• Added Transaction.bank_references.{ unstructured, structured, end_to_end }.

04.05.2021

• Added BANK.TRANSFER_DENIED.UNSUPPORTED_CURRENCY.

26.04.2021

• Added access_methods flag to bank object bank universe api.

24.03.2021

• Added new PSD2 Test Bank login keywords.

18.03.2021

• Added Account Insights common workflows.

16.03.2021

• Added Update transactions and Replace transactions.
• Added REFRESH_KNOWN_ACCOUNTS to the possible account selection types in insights refreshs.

11.03.2021

• Added bank_references description to Create transactions.

10.03.2021

• Added bank_transaction_code description to Categorized TransactionsV2.

09.03.2021

• Switched to new Account Insights report Categorized TransactionsV2.

03.03.2021

• Add new parameter allowed_accounts to flow start API to filter account list

02.03.2021

• Removed excluded_transaction_ids in Modular Report.
• Renamed excluded_account_ids to excluded_insights_account_ids in Modular Report.
• Renamed transaction_ids to insights_transaction_ids in Categorized Transactions.

02.03.2021

• Updated Storage API documentation.

02.03.2021

• Updated the way to select accounts in insights-refreshs.

25.02.2021

• Added amount field to the result of the transfer-flow.

24.02.2021

• Added insights_consumer_id field into "insights_refresh" flow when starting a session.

24.02.2021

• Updated Denmark and Portugal in countries list.

16.02.2021

• Added account_id field in Flow Insights-Refresh and Consent Insights-Refresh.

09.02.2021

• Removed Origin field requirement for White-label Integrations.

08.02.2021

• Renamed since to last_days when starting a transaction flow.

05.02.2021

• Added US to available countries for White-label Integrations.

04.02.2021

• Added specifications for consent_scope.transactions.from_date, consent_scope.transactions.to_date and consent_scope.transactions.last_days to the documentation on starting a session.

28.01.2021

• Updated countries list.

28.01.2021

• Added an example how to request consent scopes for a PIS only transfer.
• Updated the authentication documentation with usage of JWT tokens.

26.01.2021

• Added documentation of insights consent auto refresh and consent refresh.

26.01.2021

• Added filter options in modular report generation.

25.01.2021

• Added hint text for correct consent token usage after an error occurred.

22.01.2021

• Amended path for provide data.
• Added fields available, limit and reserved in request for provide data.

20.01.2021

• Added field consents in response for consent GET.

18.01.2021

• Added AccountInsights BankData update and delete endpoint.

12.01.2020

• Added a insights quick start guide.

21.12.2020

• The client_token is now also returned in calls retrieving information about a flow.

09.12.2020

• Added new Recurring Transactions report to the modular report documentation.

07.12.2020

• Added new Balances report to the modular report documentation.

30.11.2020

• Added new Account-Info report to the modular report documentation.

25.11.2020

• Separating the documentation into an integration and API reference section.

20.11.2020

• Added Transaction#booking_date and Transaction#value_date.

17.11.2020

• Added company to the insights brand response.

16.11.2020

• Added information about domestic transfers in great britain.
• Added information about Bankgirot and Plusgirot transfers in Sweden.

16.11.2020

• Added Estonia & Lithuania to Country Support Matrix.

13.11.2020

• Added redirect_return_url-parameter for klarna branded integrations.

11.11.2020

• Added description for refreshed_at in the insights report response.

11.11.2020

• Added new test bank login keywords.

10.11.2020

• Added documentation about category lookup endpoint.

09.11.2020

• Added description about default of refresh_days and report_days.

05.11.2020

• Added modular report and details about CATEGORIZED_TRANSACTIONS, EXPENSE_CATEGORIES and BALANCE_OVER_TIME reports.
• renamed Provide Transaction in Provide Bank Data.
• marked intended_reports as optional (defaults will be used).

03.11.2020

• Added bank_references field to the transfer object.

24.09.2020

• Added transfer_method fields se_bankgirot and se_plusgirot in the transfer object.
• Added SCT and Bankgirot Transfer Object to transfer_account.

10.08.2020

• Added documention about Account Insights API.

03.08.2020

• Added field consent_token in error response for consent API.

26.05.2020

• Added example for consent_scope structure in session create call.

13.05.2020

• Added documentation for transfer result where banks would use different IBAN.

04.05.2020

• Added an error handling section for the Consent API and introduced new error codes.

23.04.2020

• Updated postman collection. It now includes whitelabel support and example calls for the consent API and bank universe API. Postman collection.

16.04.2020

• Clarified that, due to limitations of PSD2 APIs, the consumer might change the sender account in a transfer even though an account was preselected during the start of the flow.
• Made Account.transfer_type & Account.account_type optional due to limitations of PSD2 APIs.
• Added documentation for Secure Communication.

02.04.2020

• Removed popup form element.

18.11.2019

• Added information about the valid_options validation error.
• General improvements to the documentation for validation.

27.08.2019

• Updated information about default languages in session creation step.

14.08.2019

• Updated Auth API documentation.
• Added documentation for psu information.
• Added PSD2 redirect happy path workflow example.

13.05.2019

• Updated XS2A Form elements switchable and choice.
  • Added field option.badge.
  • Added field option.description.

10.05.2019

• Added Bank Universe.

01.02.2019

• Added White Label Integration.

30.01.2019

• Update XS2A-app documentation.

03.01.2019

• Changed all occurrences of the Amount object to reference the associated documentation.
• Removed the currency field from the Account object as it is currently not supported/implemented.

05.11.2018

• Changelog started.