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 toget_transactions
. → Reading account transactions - The
start_simple_sepa_transfer
method was renamed tosimple_sepa_transfer
and no longer takes a TAN method and TAN medium description as an argument. → Sending SEPA transfers - The
start_sepa_transfer
method was renamed tosepa_transfer
and no longer takes a TAN method and TAN medium description as an argument. The new parameterpain_descriptor
should be passed with the version of the PAIN format, e.g.urn:iso:std:iso:20022:tech:xsd:pain.001.001.03
. → Sending SEPA transfers - The
start_sepa_debit
method was renamed tosepa_debit
and no longer takes a TAN method and TAN medium description as an argument. The new parameterpain_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 parametercor1
is optionally available. → Creating SEPA debits - Working with TANs has changed a lot.
get_tan_methos
has been renamed toget_tan_mechanisms
and has a new return data type. The chosen TAN method is now set on a client level withset_tan_mechanism
andset_tan_medium
. You can find more information in the chapter Working with TANs and a full example in the chapter Sending SEPA 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
fints.client.FinTS3Client.get_information()
was added. → Fetching bank information - It is now possible to serialize and store the state of the client to enable multi-step operations in a stateless environment. → Storing and restoring client state