How long it lasts
- The bank and the route set the end date, at most the
consent_daysyou asked for. - Every connection shows its real dates in
consent.expires_atandconsent.renew_by. - The institution shows the longest consent the bank allows in
consent_days_max. - Never promise your users a fixed number of days: say “until” the date on the connection.
Know in advance
bank.connection.consent_expiring is sent 14, 7 and 1 day before the end.
You can also list connections that end soon:
Renew
201 with a renew link, or one of these:
The page where the person completes a renewal is not available yet, so do not send people to a renew link today.
Until it is, use the reminders above to know when a consent ends.
If the consent lapses
- The connection becomes
renewal_requiredwithstatus_reason: consent_expiredorbank_requires_sign_in. - You can still read what was synced, nothing is synced or charged, and
bank.connection.renewal_requiredis sent. - After
consent.renewable_untilit isrevokedwithstatus_reason: consent_lapsed, and the person connects again.