PHPackages                             nemiah/php-fints - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. nemiah/php-fints

ActiveLibrary[HTTP &amp; Networking](/categories/http)

nemiah/php-fints
================

PHP Library for the protocols fints and hbci

4.1.0(1mo ago)156161.0k↑33.8%52[29 issues](https://github.com/nemiah/phpFinTS/issues)4MITPHPPHP &gt;=8.0CI passing

Since Aug 24Pushed 2w ago18 watchersCompare

[ Source](https://github.com/nemiah/phpFinTS)[ Packagist](https://packagist.org/packages/nemiah/php-fints)[ Docs](https://github.com/nemiah/phpFinTS)[ RSS](/packages/nemiah-php-fints/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (8)Versions (25)Used By (4)

PHP FinTS/HBCI library
======================

[](#php-fintshbci-library)

[![CI status](https://github.com/nemiah/phpFinTS/actions/workflows/tests.yml/badge.svg)](https://github.com/nemiah/phpFinTS/actions/workflows/tests.yml)

A PHP library implementing the following functions of the FinTS/HBCI protocol:

- Get accounts
- Get balance
- Get transactions
- Execute direct debit
- Execute transfer
- Note that any other functions mentioned in [section C of the specification](https://www.hbci-zka.de/dokumente/spezifikation_deutsch/fintsv3/FinTS_3.0_Messages_Geschaeftsvorfaelle_2015-08-07_final_version.pdf)should be relatively straightfoward to implement.

Forked from [mschindler83/fints-hbci-php](https://github.com/mschindler83/fints-hbci-php), but then mostly reimplemented.

Getting Started
---------------

[](#getting-started)

Before using this library (or any other FinTS library), you have to register your application with [Die Deutsche Kreditwirtschaft](https://www.fints.org/de/hersteller/produktregistrierung) in order to get your registration number. Note that this process can take several weeks. First you receive your registration number **after a couple days, but then you have to wait anywhere between 0 and 8+ weeks**for the registration to reach your bank's server. If you have multiple banks, it probably reaches them at different times.

Further prerequisites:

- to avoid error messages like: "Cannot use nemiah/php-fints's latest version 4.0.0 as it requires ext-mbstring \* which is missing from your platform." just install php-mbstring in advance.
- to avoid error messages like "As there is no 'unzip' nor '7z' command installed zip files are being unpacked using the PHP zip extension." just install unzip or 7z in advance to coninuing to next step.

Then install the library via [composer](https://getcomposer.org/download/):

```
composer require nemiah/php-fints

```

See the examples in the "[Samples](/Samples)" folder to get started on your code. Fill out the required configuration in `init.php` (server details can be obtained at [https://www.fints.org](https://www.fints.org/de/startseite) after registration). Then execute `tanModesAndMedia.php` and later `login.php`. Once you are able to login without any issues, you can move on to the other examples.

Banks with special needs
------------------------

[](#banks-with-special-needs)

If you are developing an online banking application with this library, please be aware of the following exceptions:

### Hypovereinsbank

[](#hypovereinsbank)

The BLZ 71120078 will throw an "Unbekanntes Kreditinstitut" exception when used with the URL . You have to use BLZ 70020270 instead.

```
if (trim($url) == 'https://hbci-01.hypovereinsbank.de/bank/hbci')
	$blz = '70020270';
```

### ING Diba

[](#ing-diba)

This bank does not support PSD2:

```
if (trim($blz) == "50010517")
	$fints->selectTanMode(new Fhp\Model\NoPsd2TanMode());
```

Contribute
----------

[](#contribute)

Contributions are welcome! See the [developer guide](DEVELOPER-GUIDE.md) for some background information.

We use a slightly modified version of the [Symfony Coding-Style](https://symfony.com/doc/current/contributing/code/standards.html). Please run

```
composer update
```

and

```
composer cs-fix
```

before sending a PR.

### Bank compatibility

[](#bank-compatibility)

Different banks implement different versions of the HBCI and FinTS specifications, and they also interpret the specification differently sometimes. In addition, banks behave differently (within the boundaries of the specification) when it comes to validation (some may tolerate slightly wrong requests), TANs (some ask for TANs more often than others) and allowed parameters (not all banks support all parameter combinations).

This library aims to be compatible with all banks that support [FinTS V3.0](https://www.fints.org/de/spezifikation) and PIN/TAN-based authentication according to PSD2 regulations, which includes most relevant German banks. Currently, it works with the most popular banks at least, and probably with most others too. Some corner cases (e.g. Mehrfach-TANs or SMS-Abbuchungskonto for mTAN fees) are not and probably will not be supported. Those banks with a dedicated [integration test](/Tests/Unit/Integration) have been tested most extensively.

If you encounter any problems with your particular bank, please check for open GitHub issues or open a new one.

###  Health Score

67

—

FairBetter than 99% of packages

Maintenance91

Actively maintained with recent releases

Popularity52

Moderate usage in the ecosystem

Community38

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~168 days

Total

22

Last Release

30d ago

Major Versions

1.6.0 → 2.0.02020-01-06

2.1.0 → 3.0.02020-08-17

3.7.0 → 4.0.02026-01-16

PHP version history (5 changes)1.0.0PHP &gt;=5.3.2

1.5.0PHP &gt;=5.6

2.0.0PHP &gt;=7.1

3.4.0PHP &gt;=8.0

4.0.0PHP &gt;=8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/596b638d47f8d3a2225e9c6046d59919c2c4ead74b1b2d709c368e5667c416c3?d=identicon)[nemiah](/maintainers/nemiah)

---

Top Contributors

[![nemiah](https://avatars.githubusercontent.com/u/1369437?v=4)](https://github.com/nemiah "nemiah (418 commits)")[![Philipp91](https://avatars.githubusercontent.com/u/2501211?v=4)](https://github.com/Philipp91 "Philipp91 (331 commits)")[![ampaze](https://avatars.githubusercontent.com/u/758593?v=4)](https://github.com/ampaze "ampaze (94 commits)")[![fbett](https://avatars.githubusercontent.com/u/24937658?v=4)](https://github.com/fbett "fbett (47 commits)")[![mschindler83](https://avatars.githubusercontent.com/u/2979969?v=4)](https://github.com/mschindler83 "mschindler83 (40 commits)")[![lukas-staab](https://avatars.githubusercontent.com/u/14363325?v=4)](https://github.com/lukas-staab "lukas-staab (16 commits)")[![omega3000](https://avatars.githubusercontent.com/u/13119234?v=4)](https://github.com/omega3000 "omega3000 (10 commits)")[![Metabor](https://avatars.githubusercontent.com/u/2135064?v=4)](https://github.com/Metabor "Metabor (9 commits)")[![DanielEgenolf](https://avatars.githubusercontent.com/u/48215227?v=4)](https://github.com/DanielEgenolf "DanielEgenolf (7 commits)")[![simonschaufi](https://avatars.githubusercontent.com/u/941794?v=4)](https://github.com/simonschaufi "simonschaufi (6 commits)")[![timrasche](https://avatars.githubusercontent.com/u/28338263?v=4)](https://github.com/timrasche "timrasche (6 commits)")[![werner-freytag](https://avatars.githubusercontent.com/u/3309376?v=4)](https://github.com/werner-freytag "werner-freytag (5 commits)")[![leobeal](https://avatars.githubusercontent.com/u/12049134?v=4)](https://github.com/leobeal "leobeal (5 commits)")[![stevemueller-dreamsoft](https://avatars.githubusercontent.com/u/37575071?v=4)](https://github.com/stevemueller-dreamsoft "stevemueller-dreamsoft (5 commits)")[![aaukt](https://avatars.githubusercontent.com/u/5297402?v=4)](https://github.com/aaukt "aaukt (3 commits)")[![dhm80](https://avatars.githubusercontent.com/u/4153514?v=4)](https://github.com/dhm80 "dhm80 (3 commits)")[![dsentker](https://avatars.githubusercontent.com/u/86192?v=4)](https://github.com/dsentker "dsentker (3 commits)")[![fds2610](https://avatars.githubusercontent.com/u/22282817?v=4)](https://github.com/fds2610 "fds2610 (3 commits)")[![psuet](https://avatars.githubusercontent.com/u/7604288?v=4)](https://github.com/psuet "psuet (3 commits)")[![sebcode](https://avatars.githubusercontent.com/u/508999?v=4)](https://github.com/sebcode "sebcode (3 commits)")

---

Tags

bankingfintshbciphp

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/nemiah-php-fints/health.svg)

```
[![Health](https://phpackages.com/badges/nemiah-php-fints/health.svg)](https://phpackages.com/packages/nemiah-php-fints)
```

###  Alternatives

[symfony/http-kernel

Provides a structured process for converting a Request into a Response

8.1k853.6M8.2k](/packages/symfony-http-kernel)[symfony/http-client

Provides powerful methods to fetch HTTP resources synchronously or asynchronously

2.1k330.1M4.5k](/packages/symfony-http-client)[zircote/swagger-php

Generate interactive documentation for your RESTful API using PHP attributes (preferred) or PHPDoc annotations

5.4k140.4M553](/packages/zircote-swagger-php)[nelmio/api-doc-bundle

Generates documentation for your REST API from attributes

2.3k66.1M251](/packages/nelmio-api-doc-bundle)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[api-platform/metadata

API Resource-oriented metadata attributes and factories

244.5M180](/packages/api-platform-metadata)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
