{"id":5506,"date":"2019-03-13T14:44:43","date_gmt":"2019-03-13T14:44:43","guid":{"rendered":"http:\/\/www.kaba.hr\/?page_id=5506"},"modified":"2020-12-31T14:04:43","modified_gmt":"2020-12-31T14:04:43","slug":"psd2-api-documentation","status":"publish","type":"page","link":"https:\/\/www.kaba.hr\/en\/psd2-api-documentation\/","title":{"rendered":"PSD2 API Documentation"},"content":{"rendered":"<div class=\"flexible-block\"><div class=\"am2-content clearfix  \">\n     \n        <div class=\"col-1\">\n            <p><strong>PSD2 API Documentation<\/strong><\/p>\n<p>The Payment Services Directive 2 (PSD2) regulates payment services and service providers throughout the European Economic Area (EEA). Thus, more non-banks are involved in payment transactions, consumer protection is further strengthened and the rights and obligations of payment providers and users are harmonised.<br \/>\nAmong others PSD2 contains regulations of new services to be operated by so called Third Party Providers (TPP) on behalf of a Payment Service User (PSU).<\/p>\n<h2>PSD2 services<\/h2>\n<p>The services can only be used by licensed TPPs possessing the specific eIDAS certificate. Each service offered by a TPP needs to be instructed by the customer, here called PSU.<\/p>\n<h2>Technical Documentation<\/h2>\n<p>The basis for our PSD2 XS2A Interface implementation are Berlin Group\u2019s NextGenPSD2 XS2A Framework Implementation Guidelines Version 1.3.8. and Croatian Banking Association (CBA) PSD2 API documentation.<\/p>\n<ul>\n<li><a href=\"http:\/\/www.kaba.hr\/wp-content\/uploads\/2019\/03\/Kaba-Information-on-Open-API-Bank-for-TPP_2020_12_31_ENG.pdf\">Kaba Information on Open API Bank for TPP (31.12.2020.)<\/a><\/li>\n<li><a href=\"http:\/\/www.kaba.hr\/wp-content\/uploads\/2019\/03\/Kaba-General-Testing-Conditions_2020_12_31_ENG.pdf\">Kaba General Testing Conditions (31.12.2020.)<\/a><\/li>\n<\/ul>\n<p>Technical documentation will be made available to you after you finish the registration process via <a href=\"\/psd2-api-request-for-testing\/\">this form<\/a>.<\/p>\n<p>&nbsp;<\/p>\n<h3><strong>What to expect<\/strong><\/h3>\n<p>Our <strong>technical documentation<\/strong> provides the necessary information to interact with Karlova\u010dka banka&#8217;s XS2A Interface, such as:<\/p>\n<ul>\n<li>Preconditions &#8211; Requirements you need to fulfill, so that you are able to access our services.<\/li>\n<li>Service endpoints &#8211; Information on the PSD2 specific endpoints accessible through our XS2A Interface.<\/li>\n<\/ul>\n<h3><strong>Sandbox<\/strong><\/h3>\n<p>Our Sandbox allows you, as a TPP, easy-to-use testing against our PSD2 compliant XS2A Test Interface, which corresponds to the system in operational use. Get in touch with us to get started.<\/p>\n<h3><strong>How to Sandbox<\/strong><\/h3>\n<p>Our Sandbox environment allows you to proceed an integration testing with you application and the Karlova\u010dka banka PSD2 API. The Sandbox simulates API responses in a production site behavior. Resources will be generated dynamically in the Sandbox and will be a reflection of the production API system.<br \/>\nPlease look out on Technical Documentation for more detailed information on the Sandbox test approach. The test scenarios are aligned to the <strong>KABA Test Guideline<\/strong> test cases.<br \/>\nThe test data (IBAN, User credentials etc.), provided in the <strong>KABA Test Cases<\/strong> , has to be used for the positive test scenarios, as they are linked to the underlying artificial test accounts. If you use any other test data, you will get back the correlating error message.<\/p>\n<p>Before you can get started, following steps must be fulfilled:<\/p>\n<ul>\n<li>You need a valid test or production eIDAS TLS certificate which are used for establishing a secure TLS connection (certificate for website authentication &#8211; QWAC), issued by a Qualified Trust Service Provider (QTSP). This enables Karlova\u010dka banka to identify and verify you as a TPP.<\/li>\n<li>You need to register yourself for the Sandbox. As a part of the registration process, you can provide us your e-mail address, where you want to get informed about potential downtimes or updates. Also we will provide you the detailed Test Guideline and Test Cases.<\/li>\n<\/ul>\n<h3><strong>How to register<\/strong><\/h3>\n<ol>\n<li>You contact us via <a href=\"\/psd2-api-request-for-testing\/\">registration form<\/a> and request to be registered for our Sandbox environment and the detailed Test Guideline.<\/li>\n<li>We will respond to you and ask you for the provision of the required information (e.g. eIDAS certificate details and broadcast e-mail).<\/li>\n<li>After you provide us with the requested information, we will register you in our system and create the required prerequisites to enable you for the test. After the completion we will send you a confirmation mail containing the detailed Test Guideline and Test Cases.<\/li>\n<li>Congratulations, you are ready to test with Karlova\u010dka banka!<\/li>\n<\/ol>\n<p>Are you facing technical difficulties or having questions? Please feel free to <a href=\"\/psd2-api-suggestions-and-comments\/\">contact us<\/a> for all Sandbox related topics. We will come back to you soon!<\/p>\n\n        <\/div>\n    <\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>PSD2 API Documentation The Payment Services Directive 2 (PSD2) regulates payment services and service providers throughout the European Economic Area (EEA). Thus, more non-banks are involved in payment transactions, consumer protection is further strengthened and the rights and obligations of payment providers and users are harmonised. Among others PSD2 contains regulations of new services to [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-5506","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/pages\/5506","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/comments?post=5506"}],"version-history":[{"count":5,"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/pages\/5506\/revisions"}],"predecessor-version":[{"id":7412,"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/pages\/5506\/revisions\/7412"}],"wp:attachment":[{"href":"https:\/\/www.kaba.hr\/en\/wp-json\/wp\/v2\/media?parent=5506"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}