NEWSROOM
Welcome to the Newsroom. Here you can find all news and announcements related to the Unicredit API ecosystem.
03 March 2021
Important Information
Due to planned maintenance activities payment functionality will be temporarily not available on Saturday, 6th of March 2021, 00:00 a.m. CET until 02:00 a.m. CET for our production APIs related to UniCredit Bank Austria AG, UniCredit S.p.A. (Italy) and UniCredit Bank AG (Germany).
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
22 February 2021
Important Information UniCredit Bank Austria AG: release activities 23./24.2.2021
Due to regular maintenance activities in all Internetbanking Channels, the UniCredit Bank Austria AG X2A APIs (production) will temporarily be unavailable Tuesday 23.2.2021 07:00 p.m. CET - Wednesday, 24.2.2021 max. 5:00 a.m. CET.
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
19 February 2021
Important Information: PSU IP Address validation
Starting from June 2021 an IP address validation will be introduced into our APIs for the “PSU-IP-Address” attribute.
According to Berlin Group 1.3.4 API standard, the PSU-IP-Address (forwarded IP Address header) field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
In case the IP validation fails, an error response will be returned to the TPP. All dummy IP addresses like for example 1.1.1.1 or 0.0.0.0 will trigger an error after request submission.
Please remark also for PIIS API calls the “PSU-IP-Address” will become mandatory.
15 February 2021
Important Information
Our APIs (production and Sandbox) for all countries will temporarily be unavailable for maintenance activities on Saturday, February 20th 10:30 p.m. CET – Sunday, February 21st 07:30 a.m. CET.
Also the Developer Portal will be affected.
There are no changes on the APIs or documentation because of these activities.
12 January 2021
Important Information
Our Production APIs will temporarily be unavailable for maintenance activities on Tuesday, January 19th 11:00 p.m. CET – Wednesday, January 20th 07:00 a.m. CET.
For Sandbox API only the onboarding calls will be unavailable.
The Developer Portal and the other Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
11 December 2020
Important Information
Due to planned maintenance activities the redirect for consent and payment authorisation will be temporarily not available on Sunday, 13th of December 2020, 09:00 p.m. CET until 11:00 p.m. CET for 24You (UniCredit Bank Austria AG).
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
04 December 2020
Important Information
Due to planned maintenance activities payment functionality will be temporarily not available on Sunday, 13th of December 2020, 02:00 a.m. CET until 05:00 a.m. CET for our production APIs related to UniCredit Bank Austria AG, UniCredit S.p.A. (Italy) and UniCredit Bank AG (Germany).
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
18 November 2020
Important Information: UniCredit Bank Czech Republic and Slovakia is activating Berlin Group 1.3.4 on 24th November 2020 night
On 24th November 2020 starting from 22:00 PM CET, UniCredit Czech Republic and Slovakia will activate Berlin Group 1.3.4 Productive API’s and the estimated downtime will be around 1 hour for UniCredit Czech Republic and Slovakia only (no impact is foreseen on Sandbox or API Portal).
The transition period to a Berlin Group 1.3.4 only setup (both national API standards and Berlin Group 1.3.4 API standard will co-exist for at least six months) will commence.
Do not hesitate to contact us via our support form in case of questions.
17 November 2020
Important Information
Our production APIs related to UniCredit Bank AG (Germany) will temporarily not be available due to planned maintenance activities in the Online Banking Channels. The maintenance window is planned on Thursday, November 19th 01:00 a.m. CET until 02:00 a.m. CET and on Saturday, November 21st 10:00 p.m. CET until Sunday, November 22nd 01:00 a.m. CET.
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected. There are no changes on the APIs or documentation because of these activities.
09 November 2020
Important Information
The planned and announced maintenance activity on Tuesday, 10th of November 2020, 00:00 a.m. CET until 06:00 a.m. CET will be postponed to Friday, 13th of November 2020, 10:00 p.m. CET until 14th of November 2020 04:00 a.m. CET.
The payment functionality during this time frame will be temporarily not available for our production APIs related to UniCredit Bank Austria AG, UniCredit S.p.A. (Italy) and UniCredit Bank AG (Germany).
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
05 November 2020
Important Information
Due to planned maintenance activities payment functionality will be temporarily not available on Tuesday, 10th of November 2020, 00:00 a.m. CET until 06:00 a.m. CET for our production APIs related to UniCredit Bank Austria AG, UniCredit S.p.A. (Italy) and UniCredit Bank AG (Germany).
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
03 November 2020
Important Information: New release 23./24. November
Within the release on 23./24. November 2020 for Payment Initiation Requests (Berlin Group) the checks on field “creditorAgent” will be improved.
The definition of the field is unchanged:
creditorAgent (string, optional): The BIC associated to the account.
For this optional field we currently accept also an empty string (“”).
After the release only valid BICs will be accepted.
In case no creditorAgent is needed, the field must not be provided in the service request body.
Please validate your implementation.
20 October 2020
Important Information
There might be delayed response times on our production APIs due to maintenance activities.
Impacted production APIs are related to UniCredit Bank Austria AG, UniCredit S.p.A. and UniCredit Bank AG.
The maintenance window is planned on October 22nd, 19:30 – 21:30 CEST.
Other countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
16 October 2020
Important Information
Our production APIs may temporarily be unavailable at the weekend on October 24th/25th due to planned maintenance activities.
For Sandbox API only the onboarding calls will be unavailable.
The maintenance window is planned on Sunday, October 25th 02:00 a.m. – 05:00 a.m. CEST.
The Developer Portal and the other Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
14 October 2020
Important Information
Our production APIs related to UniCredit Bank AG (Germany) will temporarily not be available due to planned maintenance activities in the Online Banking Channels.
The maintenance window is planned on Sunday, October 18th 02:00 a.m. CEST until 04:00 a.m. CEST.
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected.
There are no changes on the APIs or documentation because of these activities.
06 October 2020
Important Information: PSD2 API server certificate update
The intermediate certificate of our PSD2 API (Production and Sandbox API) will be changed this Thursday (08.10.2020 after 18:00 CEST).
The new public intermediate certificate is ‘Actalis Organization Validated Server CA G3’ (vs. ‘Actalis Organization Validated Server CA G2’ currently used).
This certificate can be downloaded directly from the Actalis web site (The certificate on the Actalis website is named ‘Certificate of the SubCA (OV class) G3’).
The subject of the new certificate is:
CN = Actalis Organization Validated Server CA G3
O = Actalis S.p.A.
L = Ponte San Pietro
S = Bergamo
C = IT
28 September 2020
Important Information: Updates about Berlin Group 1.3.4 API standard Sandbox for UniCredit Bank Czech Republic and Slovakia
As anticipated at the middle of August 2020, the Berlin Group 1.3.4 API standard Sandbox for UniCredit Bank Czech Republic and Slovakia is active now. At the start of October we will decommission the Sandbox for national API standards for Czech Republic and Slovakia and by end of 2020 we will activate the productive API’s for Berlin Group 1.3.4 API standard (while ensuring adequate transition period till we fully decommission the productive API’s for national API standards for Czech Republic and Slovakia).
Furthermore please consult the updated API documentation for Berlin Group 1.3.4 API standard for UniCredit Bank Czech Republic and Slovakia and contact UniCredit TPP support for any clarifications.
22 September 2020
Update planned release: Enhanced Transaction List API (data parity) in production for UniCredit Bank Austria
Due to a release change the planned release in production has to be postponed from 22.9. to 28.9.2020 (technical deploy on the weekend 26./27.9.2020).
During the deploy a downtime for Austrian AIS APIs only can occur on Saturday 26.9.2020 night between 22:00 and 03:00.
An update information will follow in time.
22 September 2020
New feature: management of the AuthorisationID and the SCA status management for UniCredit Bank Austria
We are happy to inform you that on the weekend 26./27.9.2020 we are implementing a new functionality for the SCA Status (authorization status) management for both payments and consents.
It will be implemented through a static mapping with the consent status received by Channels as described below:
| Consent Status | SCA Status | SCA Status description |
| pending | received | An authorisation or cancellation-authorisation resource has been created successfully. |
| valid | finalised | The SCA routine has been finalised successfully |
| rejected | failed | The SCA routine failed |
Documentation and Swagger Files are available for registered users.
Starting September 28th 2020 the API functionality will be available.
22 September 2020
New feature: Enhanced Transaction List API (data parity) in production for UniCredit Bank Austria
We are happy to inform you that the enhanced Transaction List API to provide data parity (transaction details) will be released in production for UniCredit Bank Austria (24YOU and Business Net) on the weekend 26./27.9.2020; during the deploy a downtime for Austrian AIS API only can occur on Saturday 26.9.2020 night between 22:00 and 03:00.
Please note that the pagination size will be set to 200 transactions due to the extended scope of transactional information.
Documentation and Swagger Files are available for registered users.
Starting September 28th 2020 the AIS API will be enriched with the same transaction details available to the customer in his Internet Banking channels in order to fulfil data parity
13 August 2020
Updated feature: Enhanced Transaction List API in Sandbox environment for UniCredit Bank Austria
We are happy to inform you that the enhanced Transaction List API has been released in Sandbox environment for Austria (24YOU and Business Net).
Starting on August 12th, this API will be additionally enriched with foreign payments information to provide the same transaction details available to the customer in his InternetBanking channels in order to fulfill data parity.
Please, find below all the fields that will be provided:
| Attribute | Type | Description |
| _links | Links | Link to the next page of the transactions report |
| entryReference | string Max35Text | Is the identification of the transaction as used e.g. for reference for deltafunction on application level. The same identification as for example used within camt.05x messages |
| endToEndId | string Max35Text | Unique end to end identity |
| mandateId | string Max35Text | Identification of Mandates, e.g. a SEPA Mandate ID |
| creditorId | string Max35Text | Identification of Creditors, e.g. a SEPA Creditor ID |
| bookingDate | ISODate | The Date when an entry is posted to an account on UniCredits books |
| valueDate | ISODate | The Date at which assets become available to the account owner in case of a credit |
| transactionAmount | Amount | The amount of the transaction as billed to the account. |
| creditorName | string Max70Text | Name of the creditor if a "Debited" transaction |
| creditorAccount | Account Reference | Account of the creditor |
| iban | IBAN | IBAN2007Identifier, following ISO 20022 Standard |
| bban | BBAN | It will be provided only if the IBAN is not present |
| debtorName | Max70Text | Name of the debtor if a "Credited" transaction |
| debtorAccount | Account Reference | Account of the debtor |
| ultimateDebtor | Max70Text | Ultimate debtor |
| remittanceInformationStructured | Max140Text | Reference to be transported in the field. |
| remittanceInformationUnstructured | Max140Text | Remittance Information |
| additionalInformation | additionalInformation Max512Text | Might be used to transport additional transaction related information to the PSU |
| Report Exchange Rate | Array of Report Exchange Rate | |
| sourceCurrency | Currency Code | Currency from which an amount is to be converted in a currency conversion |
| exchangeRate | String | Factor used to convert an amount from one currency to another. This reflects the price at which one currency was bought with another currency |
| unitCurrency | Currency Code | Currency in which the rate of the exchange is expressed in a currency exchange. In the example 1EUR = xxxCUR, the unit currency is EUR |
| targetCurrency | Currency Code | Currency into which an amount is to be converted in a currency conversion |
| quotationDate | ISODate | Date at which an exchange rate is quoted |
Please, note that this new feature will be delivered for Austria Real APIs on 22.9.2020 (release version to be provided).
11 August 2020
Important Information: UniCredit Bank Czech Republic and Slovakia is switching to Berlin Group 1.3.4
For Czech Republic and Slovakia there is a major change in APIs approaching. Our current solution with national Czech and Slovak standards will be changed into pan-European Berlin Group Standard. This will mean a lot of changes for you as TPPs and also for us on UniCredit side. Our goal is to provide unified solution all across UniCredit Group in every country and also to have most current API services that are provided with latest versions of Berlin Group Standard.
The Berlin Group Sandbox will be available during fall of 2020, with the go-live for the productive API’s scheduled for the end of year of 2020, more precise dates are to follow soon. A transition period from current local CZ / SK to new Berlin Group Standard for both Sandbox and productive API’s will be assured, including an updated developer portal containing all required documentations.
Do not hesitate to contact us via our support form in case of questions.
23 July 2020
Important Information
Due to planned maintenance and release activities our Sandbox and Real APIs for all countries may temporarily not be available from Friday July, 24 07:00 p.m. CEST to Monday July, 27 06:00 a.m. CEST.
21 July 2020
New feature: Cancellation of future dated payments and standing order for UniCredit Bank Germany
We are happy to inform you that we are implementing a new functionality to delete payments for Germany (Hypovereinsbank - HVB Online Banking).
With the new method, DELETE, it will be possible to cancel both single future payments and periodic payments.
Some considerations below:
- Cancellation can only be done by same TPP that initiated the payment;
- The payment that you want to delete must be fully authorized;
- The payment status must not be booked;
- The payment cancellation must be authorized by PSU (only for standing orders).
This API will be available on catalogue from July 25th.
Starting from July 27th, it will be possible to invoke this API and proceed with payments cancellation for Sandbox and Real APIs.
07 July 2020
Important Information
The attribute “additionalInformation” of “get Transactions List” call will be modified for UniCredit Bank AG on the weekend of July 24th – 26th (specific date information will be provided soon) to accommodate enhanced remittance information. Current remittance information in field “remittanceInformationUnstructured” will be kept for at least another three months.
Please, find below the details on current and future field composition:
- Current:
- "remittanceInformationUnstructured": max. 140 characters remittanceinformation
- “proprietaryBankTransactionCode”: max. 27 characters transactionCode
- “additionalInformation”: empty
- Future:
- "remittanceInformationUnstructured": max. 140 characters remittanceinformation (unchanged)
- “proprietaryBankTransactionCode”: max. 27 characters transactionCode (unchanged)
- “additionalInformation”: max. 27 characters transactionCode (unchanged) + max. 140 characters remittanceinformation (unchanged) + max. 345 characters additional remittanceinformation
Starting from today the Sandbox API will reflect already the new behaviour.
05 Jun 2020
Important Information
Due to planned maintenance activities payment functionality will be temporarily not available on Sunday June, 7 06:00 p.m. CEST until 09:00 p.m. CEST for our production APIs related to UniCredit Bank Austria AG, UniCredit S.p.A. and UniCredit Bank AG.
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected. There are no changes on the APIs or documentation because of these activities.
15 May 2020
Important Information
Due due to planned maintenance activities our APIs may temporarily be unavailable at the weekends May 16th/17th and May 23th/24th.
There are no changes on the APIs or documentation because of these activities.
14 May 2020
New feature released: Transaction List API in Sandbox environment for UniCredit Bank Austria
We are happy to inform you that new Transaction List API has been released in Sandbox environment for Austria (24YOU and Business Net).
Starting on May 15th, this API will be enriched with the same transaction details available to the customer in his InternetBanking channels in order to fulfill data parity.
Please, find below all the fields that will be provided:
| Attribute | Type | Description |
| _links | Links | Link to the next page of the transactions report |
| entryReference | string Max35Text | Is the identification of the transaction as used e.g. for reference for deltafunction on application level. The same identification as for example used within camt.05x messages |
| endToEndId | string Max35Text | Unique end to end identity |
| mandateId | string Max35Text | Identification of Mandates, e.g. a SEPA Mandate ID |
| creditorId | string Max35Text | Identification of Creditors, e.g. a SEPA Creditor ID |
| bookingDate | ISODate | The Date when an entry is posted to an account on UniCredits books |
| valueDate | ISODate | The Date at which assets become available to the account owner in case of a credit |
| transactionAmount | Amount | The amount of the transaction as billed to the account. |
| creditorName | string Max70Text | Name of the creditor if a "Debited" transaction |
| creditorAccount | Account Reference | Account of the creditor |
| iban | IBAN | IBAN2007Identifier, following ISO 20022 Standard |
| bban | BBAN | It will be provided only if the IBAN is not present |
| debtorName | Max70Text | Name of the debtor if a "Credited" transaction |
| debtorAccount | Account Reference | Account of the debtor |
| ultimateDebtor | Max70Text | Ultimate debtor |
| remittanceInformationStructured | Max140Text | Reference to be transported in the field. |
| remittanceInformationUnstructured | Max140Text | Remittance Information |
| additionalInformation | additionalInformation Max512Text | Might be used to transport additional transaction related information to the PSU |
Please, note that this new feature will be delivered for Austria Real APIs at the end of September.
07 May 2020
Important Information
We decommissioned the real APIs for Berlin Group NextGenPSD2 version 1.1. You need to migrate to the version 1.3.4, the old APIs will return a 404 error when they are still called.
In case of questions or feedback you would like to give us feel free to send us an e-mail to This email address is being protected from spambots. You need JavaScript enabled to view it.
07 May 2020
New feature released
We are happy to inform you that a new Sca Status management has been released on Sandbox for Germany.
Starting with May 07th, the values provided when you are getting the scaStatus will be:
| SCA Status | Description |
| received | Confirms the creation of authorisations resource |
| started | Advise that the PSU completed the first-factor authentication (only Embedded Approach) |
| scaMethodSelected | Advise that the PSU completed the authentication (only Redirect Approach) |
| finalised | The consent/payment have been finalized |
We want to inform you, that the new Sca status management will be delivered for real APIs for Germany at the end of July.
05 May 2020
Important Information
Due to planned maintenance activities instant payment functionality is not available from May, 8 07:00 p.m. CEST until May 9, 2020 11:00 a.m. CEST for our production APIs for UniCredit Bank Austria AG.
Other APIs, countries, the Developer Portal and the Sandbox APIs will not be affected. There are no changes on the APIs or documentation because of these activities.
24 Apr 2020
Important Information
Due to planned maintenance activities our production APIs for UniCredit SpA and buddybank (Italy) may temporarily be unavailable (Payment/Consent Authorization flow) on April, 25th from 2:00 CEST to 5:00 CEST.
Other countries, the Developer Portal and the Sandbox APIs will not be affected. There are no changes on the APIs or documentation because of these activities.
23 Apr 2020
New feature released: Instant Payments for UniCredit Bank Austria
We are happy to inform about further improvements of our X2A API for UniCredit Bank Austria:
Starting April 22nd 18:30, Instant Payments outgoing will be opened to all UniCredit Bank Austria customers for Business Net and 24You, hence also the initiation of Instant Payments will be offered via X2A API for UniCredit Bank Austria.
17 Apr 2020
Important information
We want to remind you again to migrate to Berlin Group NextGenPSD2 version 1.3.4.
We will finally decommission the real APIs for Berlin Group NextGenPSD2 version 1.1 by end of April 2020. Therefore we kindly ask you to speed up your migration activities to ensure your business continuity.
In case of questions or feedback you would like to give us feel free to send us an e-mail to
This email address is being protected from spambots. You need JavaScript enabled to view it.
25 Mar 2020
New feature released: Account Owner Name
The new attribute “ownerName”, which specifies the owner name of a certain account, will be provided as additional information in the GET /hydrogen/v1/accounts/{account-id} call.
The attribute will be released for Italy (Retail go-live on 25.03, Corporate go-live on 06.04), Austria (24YOU/BUSINESSNET go-live on 25.03, UCEBANKINGGLOBAL go-live on 06.04), Germany (HVB_ONLINEBANKING go-live on 16.04, UCEBANKINGGLOBAL/UCEBANKINGGLOBAL_UK go-live on 06.04), Slovenia (Retail go-live on 07.04, Corporate go-live on 27.07), Romania (Retail go-live on 07.04, Corporate go-live on 27.07), Bulgaria (Retail go-live on 07.04, Corporate go-live on 27.07), Croatia (Retail go-live on 07.04, Corporate go-live on 27.07) and Hungary (Retail go-live on 07.04, Corporate go-live on 27.07)
25 Mar 2020
New feature released: Standing Orders
The new structure “information”, which specifies the list of standing orders of a certain account, will be provided as additional structure in the GET /hydrogen/v1/accounts/{account-id}/transactions call setting the query parameter “bookingStatus” equals to “information”.
The attribute will be released for Austria (24YOU go-live on 25.03) and Germany (HVB_ONLINEBANKING go-live on 16.04)
25 Mar 2020
New feature released: Pending Payments
The new structure “pending”, which specifies the list of pending payments of a certain account, will be provided as additional structure in the GET /hydrogen/v1/accounts/{account-id}/transactions call setting the query parameter “bookingStatus” equals to “pending” or “both”.
The attribute will be released for Austria (go-live on 06.04)