File: upgrading_1_2.rst

package info (click to toggle)
python-fints 4.0.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 700 kB
  • sloc: python: 5,021; makefile: 196
file content (35 lines) | stat: -rw-r--r-- 2,053 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
Upgrading from python-fints 1.x to 2.x
======================================

This library has seen a major rewrite in version 2.0 and the API has changed in a lot of places. These are the most
important changes to know:

* The ``get_statement`` method was renamed to ``get_transactions``. → :ref:`transactions`

* The ``start_simple_sepa_transfer`` method was renamed to ``simple_sepa_transfer`` and no longer takes a TAN method
  and TAN medium description as an argument. → :ref:`transfers`

* The ``start_sepa_transfer`` method was renamed to ``sepa_transfer`` and no longer takes a TAN method and TAN
  medium description as an argument. The new parameter ``pain_descriptor`` should be passed with the version of the
  PAIN format, e.g. ``urn:iso:std:iso:20022:tech:xsd:pain.001.001.03``. → :ref:`transfers`

* The ``start_sepa_debit`` method was renamed to ``sepa_debit`` and no longer takes a TAN method and TAN
  medium description as an argument. The new parameter ``pain_descriptor`` should be passed with the version of the
  PAIN format, e.g. ``urn:iso:std:iso:20022:tech:xsd:pain.008.003.01``. Also, a new parameter ``cor1`` is optionally
  available. → :ref:`debits`

* Working with TANs has changed a lot. ``get_tan_methos`` has been renamed to ``get_tan_mechanisms`` and has a new
  return data type. The chosen TAN method is now set on a client level with ``set_tan_mechanism`` and
  ``set_tan_medium``. You can find more information in the chapter :ref:`tans` and a full example in the chapter
  :ref:`transfers`.

* Debug logging output now contains parsed syntax structures instead of data blobs and is much easier to read.

* A new parser for FinTS has been added that is more robust and performs more validation.

In exchange, you get a couple of great new features:

* A new method :func:`fints.client.FinTS3Client.get_information` was added. → :ref:`information`

* It is now possible to serialize and store the state of the client to enable multi-step operations in a stateless
  environment. → :ref:`client-state`