Documentation Changelog
27.03.2023
- Added more reports to the bulk report
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
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
08.08.2022
- Added the references
message
, opposing_message
, mandate
, additional_information
and national
to the response calls of a transaction call
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.
20.06.2022
- Added
auth_url
to redirect/start
response
18.05.2022
- Added
redirect/start
endpoint documentation
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.
07.03.2022
- Added new field
appearenceMode
and skipInitialLoader
to XS2A App configuration.
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.
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.
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.
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.
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.
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.
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.
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
- Updated
Denmark
and Portugal
in countries list.
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
- 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.
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
.
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
.
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.