404 zurück, bis der Live-Zugriff angekündigt wird.
Einmaliger und laufender Zugriff
Laufender Zugriff funktioniert bei einer Bank nur, wenn diese Bank ihn zulässt.
Fragen Sie den Endpoint für Institutionen ab oder lesen Sie die Abdeckungsseite.
Kann eine Bank den Zugriff nicht offen halten, wird der Person mitgeteilt, dass die Bank keinen laufenden Zugriff erlaubt, und sie muss eine andere Bank wählen.
Setzen Sie
allow_one_time_fallback: true, damit die Person nach der Bestätigung des eingeschränkten Zugriffs auf ihrem eigenen Bildschirm mit einem einmaligen Auslesen fortfahren kann. Die Verbindung ist dann one_time.
Status
status_reason ist einer der folgenden Werte: collection_complete, consent_expired, consent_lapsed, bank_requires_sign_in, revoked_by_end_user, revoked_by_bank, revoked_by_customer, insufficient_balance, paused_by_customer (reserviert, derzeit setzt ihn kein Endpoint) und first_sync_failed.
Einwilligung
Die Bank legt das Ende der Einwilligung fest, höchstens jedoch für den mitconsent_days angeforderten Zeitraum.
Jede Verbindung zeigt ihre tatsächlichen Daten unter consent an:
expires_atundrenew_by: das Ende der Einwilligung. Erneuern Sie die Verbindung davor, damit keine Lücke entsteht.renewable_until: der letzte Zeitpunkt, zu dem dieselbe Verbindung nach dem Ende der Einwilligung noch reaktiviert werden kann.renewed_count,version,scopes_grantedundaccounts_granted: was gewährt wurde und wie oft die Einwilligung erneuert wurde.
Erneuerung
Eine Erneuerung behält die Verbindungs-ID und jede Konto-ID bei, und der Verlauf wird ohne Duplikate fortgeführt.- Didit sendet
bank.connection.consent_expiring14, 7 und 1 Tag vor Ablauf. - Rufen Sie
POST /v3/bank/connections/{id}/renew/auf. Solange mehr als 30 Tage übrig sind, antwortet der Endpoint mit409 renewal_not_needed. Nachconsent.renewable_untilantwortet er mit409 renewal_window_expired. Andernfalls antwortet er mit201und einem Erneuerungslink.
renewal_required: Die Daten bleiben im zuletzt synchronisierten Stand lesbar, und es fallen keine Kosten an. Nach consent.renewable_until hat die Verbindung den Status revoked mit status_reason: consent_lapsed, und die Person verbindet sich erneut.
Den vollständigen Ablauf finden Sie unter Eine Bankeinwilligung erneuern.
Zugriff beenden
Das Beenden des Zugriffs ist nicht dasselbe wie das Löschen.
Lesen Sie Daten, Einwilligung und Löschung, um genau zu erfahren, was beim Löschen entfernt wird.
Eine gelöschte Verbindung
Eine gelöschte Verbindung liefert nurid, status (deleted), status_reason, created_at und erasure.
status_reason ist deleted_by_customer, consent_lapsed, retention_elapsed oder application_deleted.
Alle anderen Felder fehlen.
Duplikate
Ein neuer Link, der zu genau den Konten führt, die Sie bereits mit demselbenend_user.reference bei derselben Bank teilen, wird als Erneuerung dieser Verbindung abgeschlossen (reused: true), und es wird nichts doppelt berechnet.
Jede andere Überschneidung setzt den Link auf failed mit duplicate_conflict und conflicts_with, bevor etwas gespeichert oder berechnet wird.
Erneuern Sie die bestehende Verbindung oder erstellen Sie den Link erneut mit "duplicates": "allow" für eine unabhängige zweite Verbindung.
Verbindungen Ihrer Kunden verwalten
- Liste mit Filtern:
GET /v3/bank/connections/akzeptiertstatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeundcreated_after. - Anhand des Objekts
billingsehen Sie, was eine Verbindung kostet: die Einheit, den Preis und den bereits abgerechneten Monat.