https://github.com/prior99/fints

Typescript FinTS client library.
https://github.com/prior99/fints

Last synced: about 1 year ago
JSON representation

Typescript FinTS client library.

• Host: GitHub
• URL: https://github.com/prior99/fints
• Owner: Prior99
• License: mit
• Created: 2018-09-02T11:05:10.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-06-15T09:34:05.000Z (about 2 years ago)
• Last Synced: 2025-04-09T22:51:07.469Z (about 1 year ago)
• Language: TypeScript
• Size: 728 KB
• Stars: 17
• Watchers: 4
• Forks: 13
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# fints

[![pipeline status](https://gitlab.com/prior99/fints/badges/master/pipeline.svg)](https://github.com/Prior99/fints)

[![coverage report](https://gitlab.com/prior99/fints/badges/master/coverage.svg)](https://github.com/Prior99/fints)

A client library for communicating with [FinTS servers](https://www.hbci-zka.de/).

> Before using any FinTS library you have to register your application with Die Deutsche Kreditwirtschaft 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.

>

> -- https://github.com/nemiah/phpFinTS

## Packages

This library is maintained in a [monorepo using lerna](https://lernajs.io/). These packages are included:

 * [fints](packages/fints) (Take a look for library usage instructions.)

 * [fints-cli](packages/fints-cli) (Take a look for CLI usage instructions.)

## Mentions

FinTS is a complex and old format and this library wouldn't have been possible without the great work of:

- [python-fints](https://github.com/raphaelm/python-fints) was used a reference implementation.

- [Open-Fin-TS-JS-Client](https://github.com/jschyma/open_fints_js_client) provides a demo server used for testing this library.

- [mt940-js](https://github.com/webschik/mt940-js) is used internally for parsing the [MT940](https://en.wikipedia.org/wiki/MT940) format.

## Resources

- [API Reference](https://prior99.gitlab.io/fints)

- [Official specification](https://www.hbci-zka.de/spec/3_0.htm)

- [Database of banks with their URLs](https://github.com/jhermsmeier/fints-institute-db)

## Contributing

Contributions in the form of well-documented issues or pull-requests are welcome.

## Contributors

 - Frederick Gnodtke