Newsroom
Welcome to the Newsroom. Here you can find all news and announcements related to the Unicredit API ecosystem.
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 June 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
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.