European cross border Instant Payment (Swedbank Baltics)

As of June 12, 2025 in addition to European domestic instant payments single European cross border payments to the recipient bank participating in the instant payment settlement system can be executed as instant payment. Instant European cross border payment will be available in PSD2 API as in Internet Bank or mobile app. Applicable for Swedbank Baltics and not Swedbank Sweden.

Developer Recommendations for Efficient API Usage

In the light of our recent review of common errors and monitoring results concerning API service availability and performance, we have compiled a set of best practices for your consideration. These guidelines aim to enhance collaboration and ensure that API clients use services efficiently without overloading system performance:

1. Error Handling and Retries

Enhanced Error Handling: Improve error handling mechanisms rather than repeatedly calling APIs after failures.

Actionable Errors: Take actions on errors such as:

TOKEN_UNKNOWN

TOKEN_EXPIRED

MISSING_HEADER

FORMAT_ERROR

Client-Side Throttling: Implement throttling for errors such as:

TOO_MANY_PARALLEL_REQUESTS

TOO_MANY_REQUESTS

2. Efficient Data Retrieval

Selective Fields: Request only necessary fields or data points, avoiding retrieval of entire datasets. For example, specify parameters like bookingStatus, withBalance, etc.

Use Pagination: Benefit from pagination functionality when retrieving account statements.

Result Storage: Avoid multiple requests for large account statements within the same period; store results instead.

3. Optimize Request Frequency

Client-Side Caching: Cache responses locally to minimize repeated requests for unchanged data.

Optimized Scheduling: Schedule non-critical operations during off-peak hours to reduce server load.

Spread Batch Loads: Distribute batch requests over several hours to mitigate server overload.

Decrease status call exponentially. Have in mind that authorisation is usually performed by human so consider calling authorisation status into logical intervals and stop calling after certain time where signature is not expected, eg.5 minutes.

4. Understanding Workflow

Correct Status Checks: Ensure that authorization status is called before checking payment or consent resource status.

Endpoint Optimization: use only needed endpoints and scopes for the particular use case. Eg. do not create balance consent if the account balance won’t be requested.

5. Setup in Developer Portal

Certificate Renewal: Add new certificate for existing application, do not create new application for certificate renewal. Swedbank keeps all onboarded certificates in it's local cache, so overriding certificate does not affect application usage.

Application Management: Consider separate applications for different services or merchants to streamline operations.

 These recommendations are designed to improve system efficiency and facilitate seamless integration with our API services. We appreciate your cooperation in implementing these best practices to optimize performance across all interactions.