Support

How can I register?

To register for access to the developer portal click here. You will need to provide your email address. We will send an activation link to the email address you provided.

You must then set a user name and password to access the functionality on our developer portal.

What APIs have been provided under PSD2?

KBC Ireland had provided APIs for the following:

Is there a swagger?

Yes. Swagger definition for our APIs is available on the developer portal. You can access them once you have completed the registration process. 

Access the ‘Develop’ section on our developer portal for detailed information.

Are there different versions?

No. At the moment we have only one version of the APIs available on our Sandbox.

Where do I access the technical documentation?

You can access detailed specifications of our APIs on the developer portal. You can access them once you have completed the registration process.

Access the ‘Develop’ section on our developer portal for detailed information.

If I can’t figure something out for myself, where do I go?

We are always there to help you integrate with our APIs and offer innovative solutions. You can always reach us at apidevelopersupport@kbc.ie for any information.

How do I report a bug ?

You can report any issue at apidevelopersupport@kbc.ie.

Are there use cases and journeys for a client? Pictures or steps to the processes?

Follow the steps on the Get started page to set up your test environment to access our API Sandbox.

The process for getting access to production is explained here.
 

What API standards is KBCI complying with?

KBC Ireland has chosen to align with the Open Banking UK specifications for the APIs, which will allow regulated financial service providers to access information on customer’s accounts with their permission.

We will comply with v3.1 of the specifications.

More information on the open banking standards can be found here.

Are the APIs available in production?

Yes, our APIs are available in production since September 2019.

How do I programmatically test?

Follow the steps on the Get started page to setup your test environment to access our API Sandbox.

Once I’ve tested and am happy my application can interact with your APIs, do I need to let you know or can my application just start firing thousands of requests at you to handle?

Our Sandbox allows you to access test data only and we appreciate a fair usage of the same. Once you are confident that your application is ready to move to production and you have acquired all the valid permissions you can get access to our production environment.

The process for getting access to production is explained here.
 

What security standards do I need to know about to interact/onboard?

Our APIs on the sandbox meet the latest security standards and are built on oAuth framework. Additionally, it complies with the security profile as specified in the Open Banking standards.

How can I explicitly use the APIs in Sandbox?

Follow the steps on the Get started page to setup your test environment to access our API Sandbox

How do I get access to production?

KBC Ireland provides a dynamic registration API, which enable you to register your application. You can find more details of the API here.

Are there any exceptions to the API standards?

The Payments API of KBC Ireland is based on the Open Banking UK standards (v3.1). However, there are restrictions on the maximum length allowed in some fields of the API. If the data does not meet these specifications the requests will not be accepted.

The exceptions are on the following endpoints:
  • POST /domestic-payment-consents
  • POST /domestic-payments
 
Path Open Banking (Max length) KBC Ireland(Max length)
/Data/Initiation/InstructionIdentification 35 16
/Data/Initiation/LocalInstrument 50 35
/Data/Initiation/InstructedAmount/Amount 19 18
(max 2 decimals)
/Data/Initiation/DebtorAccount/Name 70 35
/Data/Initiation/CreditorAccount/Name 70 65
/Data/Initiation/CreditorPostalAddress/AddressLine 7 x 70 3 x 65
/Data/Initiation/RemittanceInformation/Reference 35 27
/Data/Initiation/RemittanceInformation/Unstructured 1 x 140 1 x 35
/Risk/DeliveryAddress/AddressLine 2 x 70 2 x 65
/Risk/DeliveryAddress/TownName 35 16

Are there any limits on the payment amount?

For security and fraud purposes, there are limits set on the payments API.
You can transfer up to €5,000 per transaction, up to a maximum of €15,000 per day subject to availability of cleared funds and product rules.

If you wish to complete a transfer for an amount greater than the daily limit, this will need to be split across 2 or more working days.

Are there any limits to the period for which I can request account transaction data?

Our customers can view transactions on their accounts in the last 90 days via our digital channels. The GET/accounts/{accountId}/transactions endpoint replicates this limit.

In case you do not have a date range specified in the request on the transactions endpoint we will always return data for the last 90 days.
 

What account types are available on the APIs?

 
Scope Account Types
Accounts Current Accounts, Credit Cards
Payments Current Accounts
Confirmation of Funds Current Accounts, Credit Cards

What is the openid configuration endpoint for production?

You can find the configuration details here.

You will need a valid EIDAS certificate (QWAC) to access this endpoint.

What is the FAPI financial ID for KBC Ireland?

The FAPI financial ID for Sandbox is “KBCI” and for production it is “PSDIE-CBI-C26910”.

What kind of EIDAS certificates are required to access KBC Ireland APIs in production?

You will need a valid QWAC to access each endpoint (including the token endpoints) of KBC Ireland APIs.

In addition to this some endpoints (as defined by Open Banking UK standards) include a JWS header in request and responses. The signature in the JWS should be generated using a valid QSEAL.

The server hosting the JWKS should also use a QWAC for identification.

What are the expiration period for the access tokens?

Our access tokens are JWTs and has claims for expiration period of each token type. These values are in seconds.

Further questions?

If you have any further questions please don’t hesitate to contact us at apidevelopersupport@kbc.ie