TPP Journey

The information contained in this section is intended to facilitate TPP in the development of applications using the Postbank PSD2 API.

PSD2 API Sandbox enables training and help developers familiarize themselves with methods of accessing data within PSD2 open banking. The API follows the Berlin Interoperability Interface Interoperability Specifications of the Berlin Group and the BISTRA National Market Initiative. The Postbank API can be enriched to expand scope. The current Sandbox implementation and services are based on BISTRA version 1.3. We encourage you to provide feedback in order for us to improve our services by sending an email to tppsupport@postbank.bg.

Versions

Developer Portal – on-boarding

1. Use the GETTING STARTED tab for detailed information. At the bottom of the page you can download complete instructions for the Postbank Developer Portal
2. Sign up now to create an account and get started. It is free to join. Create an account by clicking the button on the top right of the portal. After filling in the required information you will receive an e-mail for successful registration
3. Log into the Developer Portal by clicking the 'Log in' button on the top right of the portal.
4. To use the API you have to register your application. Application registration is available after you login. When you register an application, the application is assigned a unique client ID and client secret. You must use the client ID when you call an API that requires you to identify your application by using a client ID, or a client ID and client secret. Check the API description for the details. When creating your new application, give it a name, a description and a redirect URL. To use PSD2 APIs, you also need to add the public part of a QWAC (Qualified Website Authentication Certificate) when registering your application. For this purpose please use the test certificate from here.
5. Once you've created an app, you need to subscribe to the API you want to develop. Select it from the "API PRODUCTS" section and click on the subscription button and select the application you created in step 4.
6. After subscribing, you can begin testing.

PSD2 API Information

• APIs in sandbox are secured with TLS Mutual Authentication.
• We do not support JWS client assertion.
• As part of our implementation we support registration of an application with single oAuth2 redirect URLs. The TPP registers a redirect URL when creating an application on the Developer Portal, however once an application has been created and the Client ID and Client Secret generated it can be changed.
• Signing the data requests - in this release signing is not used for all API’s endpoints. Signing on application layer will be mandatory on upcoming releases.
• JSON format is used for services.
• The API sandbox consists of static mocked data for:
•  
  • Account Information Services (AIS) as defined by article 67 in the PSD2 Directive.
  • Payment Initiation services (PIS) as defined by Article 66 in the PSD2 Directive.
  • Confirmation on the availability of funds (CFS) as defined by Article 65 in the PSD2 Directive.
  • PSU data used for creating consent and request an OAuth2 token.
• API PIS SANDBOX does not provide the ability to perform PSU's SCA tests after initiating a TPP payment.

The approach used for SCA is REDIRECT and after the PSU is redirected to the Bank's authorization site, the action will be taken entirely by the PSU. In the real process, but in the productive environment, after the SCA process is completed, the authorization site will redirect the PSU to the application URL of the TPP application (the URL specified when registering the App in the Developer Portal).

• The character set is UTF 8 encoded. This specification is only using the basic data elements "String", "Boolean", "ISODateTime", "ISODate", "UUID" and "Integer" (with a byte length of 32 bits) and ISO based code lists.
• We do not provide a paginated response for GET operations that return multiple records.

The sandbox uses following accounts:

Work with the PSD2 APIs

Authorization for using API in Sandbox

For information about the Authorization process, predefined User Credential used for the developing take a look here:

https://developer.postbank.bg/authorization

The callback URL you registered in the application MUST match the redirect_uri you pass as query parameter in this process.

API Endpoints used in Sandbox

API Endpoints used in Live

Error Codes and Responses

Every response returned by APIs has a response code. Response codes can be used to check the result of the requests e.g. was the request successful or did it fail.  
The following table shows the return codes used by API.

Additional information about the error may be passed using the data element “tpp_messages” in any JSON response message.

Account information service API (AIS)

Services and end points

Rules

Consent:

• the maximum validity of consent is 180 days

Account information service:

• the list of account contains only the accounts the user has given access to TPP

Payment initiation service API (PIS)

Services and end points

Payment product

• domestic-credit-transfers-bgn
• domestic-budget-transfers-bgn
• sepa-credit-transfers
• cross-border-transfers

Rules

• Only positive amounts will be accepted;
• Initiating payment is possible only from an account with one single owner
• There is daily limits for the payments

Confirmation of funds API (CFS)

Services and end points

Rules

• Only positive amount will be checked