有効期間
- 銀行とルートが終了日を決めます。上限は、リクエストした
consent_daysまでです。 - 各接続の実際の日付は、
consent.expires_atとconsent.renew_byに表示されます。 - 金融機関は、銀行が許可する最長の同意期間を
consent_days_maxに表示します。 - ユーザーに固定の日数を約束することは絶対にしないでください。接続に表示された日付「まで」と伝えてください。
事前に把握する
bank.connection.consent_expiring は、終了の14日前、7日前、1日前に送信されます。
終了間近の接続を一覧で取得することもできます:
更新
201 と更新リンクが返されます。または、次のいずれかが返されます。
本人が更新を完了するページはまだ提供されていません。そのため、現時点では更新リンクを本人に送らないでください。提供されるまでは、上記のリマインダーを使って、同意がいつ終了するかを把握してください。
同意が失効した場合
- 接続は
renewal_requiredになり、status_reason: consent_expiredまたはbank_requires_sign_inになります。 - 同期済みのデータは引き続き参照できますが、新たな同期も課金も行われず、
bank.connection.renewal_requiredが送信されます。 consent.renewable_untilを過ぎると接続はrevokedになり、status_reason: consent_lapsedになります。その後、エンドユーザーは再度接続する必要があります。