This website uses cookies to give you the best possible experience. By continuing to browse this website, you consent for cookies to be used. For more details

NEWSROOM

Welcome to the Newsroom. Here you can find all news and announcements related to the Unicredit API ecosystem.

 

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)