Subsembly EBICS API
Copyright © 2009-2021 Subsembly GmbH
The release notes (in German only) can be found here.
The Subsembly EBICS API consists of several core assemblies compiled for .NET Standard 2.0 and some optional assemblies compiled for .NET Framework 4.7.2. See https://docs.microsoft.com/de-de/dotnet/standard/net-standard for a table of .NET Standard 2.0 compatible platforms.
All Runtime files are now stored in the folder bin in the Subsembly.EBICS.zip. For an easy deployment, simply copy all files from this bin folder to your installation directory.
The following core assemblies were compiled for .NET Standard 2.0 and must be installed with your applications. These can be added to any project that targets a .NET Standard 2.0 compatible environment:
For internationalization the following text resource files are included.
Also, you must add a NuGet reference to System.Text.Encoding.CodePages by Microsoft (see https://www.nuget.org/packages/System.Text.Encoding.CodePages/4.7.1), or add the following files to your installation:
The following assemblies are only supported on Windows and have been compiled for .NET Framework 4.7.2:
- Subsembly.EBICS.SmartCard.dll (only if smart cards are used)
- Subsembly.SmartCard.dll (only if smart cards are used)
The following essential tools are included with the Subsembly EBICS API for redistribution and should be installed, when neeed.
In addition the following files should be added to your development environment in order to support the Visual Studio Intellisense:
All of these assemblies and files are contained in the Subsembly EBICS API software development kit.
The current Subsembly EBICS API software development kit can be downloaded from
A complete and coherent set of all Subsembly API assemblies is also available, and can be downloaded from
If you are using multiple Subsembly APIs, then you should always work with the assemblies contained in the Subsemblies.zip package.
IMPORTANT: License Token
In order to use the Subsembly EBICS API you will need a valid license token. The license
token may be installed alongside the assemblies using the file name
the token may be passed to the static method
The Subsembly EBICS API is divided into three separate assemblies.
The Subsembly.EBICS.Core.dll contains the platform neutral base classes. These can be used on any platform. All classes in this assembly are part of the Subsembly.EBICS namespace.
The Subsembly.EBICS.SmartCard.dll contains additional classes for supporting HBCI smart cards. These classes are only supported on Windows and macOS platforms. All classes in this assemblys are also part of the Subsembly.EBICS namespace.
The Subsembly.EBICS.Win32.dll contains UI classes for Windows only. These classes require a true Windows platform with .NET Framework 4.7.2. The classes of this assembly use the Subsembly.EBICS namespace.
The following system environment variables may be set to configure the Subsembly EBICS API and the EBICS Spooler. These are also accessible through the static EbicsConfig class.
A complete, rooted path to the directory where the EbicsContact objects are stored by default. See EbicsContactFolder.Default. If this is not set, then a folder Subsembly/EBICS below the Environment.SpecialFolder.ApplicationData folder will be used.
A complete, rooted path to the directory that acts as the root for the EBICS Spooler storage. See EbicsFileSpooler. If this is not set, then a folder Subsembly/EBICSSpooler below the Environment.SpecialFolder.ApplicationData folder will be used.
A complete, rooted path to the directory where the binary executables of the Subsembly EBICS API have been installed. This must be set explicitly for the EBICS Spooler Task.
The Subsembly EBICS API includes an EBICS file spooler facility to automate downloads of account statements and reports and uploads of SEPA payment files. The EBICS file spooler is made available through the Subsembly.EBICS.EbicsFileSpooler and associated classes. In addition a EbicsSpooler command line application is included which can be started manually, or automatically through some operating system timer facility, e.g. the Windows Task Scheduler or a Cron job.
On Windows the Subsembly.EBICS.Win32.dll provides a default EbicsSpoolerTask that integrates with the Windows Task Scheduler. The default EBICS Spooler Task can also be managed through the EbicsAdmin application for Windows.
The ZIP file contains the C# source code of the sample application EbicsCmd.