About

Welcome to the K&H bank Corporate API developer portal. You can find all the necessary information for the K&H Corporate API implementation and to integrate with your ERP systems. The K&H Corporate API provides:

  • Automatic account and balance information
  • Secured transaction initiation and authorization

The K&H Corporte API uses REST API request as per the Berling Group 1.3.3 initiative. Please note that the K&H Corporate API is different than the K&H Open API service. In case you are willing to connect as a third party service provider, please visit the K&H Open API developer portal: www.kh.hu/web/kh-api/home

For using and setup the K&H Bank Corporate API, you need WebElectra service contract. For the initial setup of the K&H Corporate API please see the WebElectra user guide (www.kh.hu/web/eng/corporate/electronic-services/electra) In case you don’t have WebElectra service, please contact your relationship manager or our Customer Service.

Documentation

Please use the following manuals to get to know our API solution.

Swagger

Most importantly, this is the swagger file that defines our API services.

View
Download

Release notes

Here you will find additional information on using our services, like which optional Berlin Group elements were implemented and how to use the sandbox solution.

Download

pain.001

You can upload payments or bulk payments in standard ISO20022 (pain.001) XML format. This extensive document describes which data members will be imported and which ones will be ignored.

Download

Code Book

There are a few proprietary code sets used by our solution, like currency codes, status codes and transactions types. Use this code book the present accurate information to your customers.

Download

Error Codes

This API uses standard RFC7807 error codes as proposed by the Berlin Group standard. This documentation contains all the possible error codes, their meaning and hints on how to resolve them.

Download

Technical documentation

Edit technicaldoc.txt to change this text

Download

Certificates

If you do not yet have a client certificate then you can use the following test keys and certificates. Download them on following links below and set up your testing environment so it presents them when you create the SSL connection. Select the certificate with the appropriate role and corresponsing key that best matches your testing scenario. Please note that the sandbox will only accept the certificates provided here.

This certificate contains all available roles. You can use it to get account information, initiate payments and check funds.

Endpoints

Our sandbox and production access endpoints are as follows

Sandbox

https://corporate-api.kh.hu/corporateapi/sb

  • URL prefix: /v1/
  • (e.g. https://https://corporate-api.kh.hu/corporateapi/sb /v1/accounts)

Production

https://corporate-api.kh.hu/corporateapi

  • URL prefix: /v1/
  • (e.g. https://https://corporate-api.kh.hu/corporateapi /v1/accounts)

Contact Us

K&H Bank

K&H címe
1095 Budapest, Lechner Ödön fasor 9.

vallalatiugyfelszolgalat@kh.hu

+36 1 468 7777