> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 銀行連携: 継続的アクセス・同意・再承認

> 連携とは、一つの銀行のデータを読み取ることに対する本人の許可です。Diditで連携のステータス、同意の終了条件、更新方法、アクセス停止とデータ削除の手順を確認できます。

Didit の銀行接続とは、個人または法人が、お客様のアプリケーションに対して1つの銀行を読み取ることを許可する仕組みです。接続には同意日、同期状態、口座が含まれます。
完了した[銀行リンク](https://docs.didit.me/ja/core-technology/bank-verification/bank-link.md)により接続が作成され、接続は銀行と本人が許可する期間にわたって有効です。

銀行データはサンドボックスアプリケーションで利用できます。本番環境のアプリケーションからの呼び出しは、本番環境へのアクセスが発表されるまで `404` を返します。

## 一回限りのアクセスと継続的なアクセス

| | 一回限り | 継続的 |
| - | - | - |
| `access` | `one_time`（デフォルト） | `ongoing` |
| 動作 | データは接続時に一度だけ読み取られ、その後アクセスは終了します（`status_reason: collection_complete`）。 | 同意が終了するか、誰かが停止するまでアクセスは維持されます。 |
| その後のデータ | 同じエンドポイントから読み取れます。 | 銀行によって1日1回から4回まで自動的に同期されるほか、必要に応じてライブ同期も行えます。 |
| 課金 | チェックごと。[料金](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md)を参照してください。 | 有効な接続1件あたり、月額。[料金](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md)を参照してください。 |

継続的なアクセスは、銀行がそれを許可している場合にのみ利用できます。
[金融機関一覧のエンドポイント](https://docs.didit.me/ja/standalone-apis/bank-institutions-list.md)に問い合わせるか、[対応状況のページ](https://docs.didit.me/ja/core-technology/bank-verification/coverage.md)をご覧ください。
銀行がアクセスを維持できない場合、その銀行は継続的なアクセスを許可していないことがエンドユーザーに通知され、別の銀行を選択する必要があります。
`allow_one_time_fallback: true`を設定すると、エンドユーザーは自身の画面で制限されたアクセスを確認したうえで、一回限りの読み取りとして続行できます。その場合、接続は`one_time`になります。

## 状態

| `status` | 意味 | データの参照 | 同期 | 課金 |
| - | - | - | - | - |
| `pending` | リンクでの手続きが完了し、最初の同期を実行中です。 | まだ不可 | 実行中 | いいえ |
| `active` | 同意は有効で、同期は正常に動作しているか、再試行中です。 | はい | はい | はい |
| `renewal_required` | 同意が終了したか、銀行が本人に再度サインインを求めています。理由は `status_reason` に示されます。 | 最後の同期時点のデータ | いいえ | いいえ |
| `paused` | 残高で当月分をカバーできません。 | 最後の同期時点のデータ | いいえ | いいえ |
| `revoked` | 本人、銀行、またはお客様によってアクセスが停止されました。誰が停止したかは `consent.ended_by` に示されます。 | `consent.retain_until` まで | いいえ | いいえ |
| `deleted` | 接続とそのデータは削除されました。 | いいえ | いいえ | いいえ |
| `failed` | 最初の同期が一度も成功していません。 | いいえ | いいえ | いいえ |

`status_reason` は次のいずれかです: `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`（予約済み。現在どのエンドポイントも設定しません）、`first_sync_failed`。

## 同意

銀行が同意の終了時期を決定します。ただし、リクエストで指定した`consent_days`が上限です。
各接続の実際の日付は`consent`に表示されます:

* `expires_at`と`renew_by`：同意の終了時期です。利用を途切れさせないために、終了前に更新してください。
* `renewable_until`：同意の終了後に、同じ接続を再有効化できる最後の時点です。
* `renewed_count`、`version`、`scopes_granted`、`accounts_granted`：付与された内容と、更新された回数です。

同意の有効期間は、銀行が許可する期間によって決まります。実際の値は各接続で、銀行ごとの値は金融機関の情報で確認してください。

## 更新

更新では、接続IDとすべてのアカウントIDが維持され、履歴は重複せずに引き続き記録されます。

1. Diditは、終了の14日前、7日前、1日前に`bank.connection.consent_expiring`を送信します。
2. [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/ja/standalone-apis/bank-connection-renew)を呼び出します。残りが30日を超えている間は`409 renewal_not_needed`を返し、`consent.renewable_until`を過ぎると`409 renewal_window_expired`を返します。それ以外の場合は、更新リンクとともに`201`を返します。

利用者が更新を完了するページは、まだ提供されていません。そのため、現時点では更新リンクを利用者に送らないでください。

利用者が同意を更新せず失効させた場合、接続は`renewal_required`になります。データは最後に同期された状態で引き続き閲覧でき、料金は発生しません。
`consent.renewable_until`を過ぎると、接続は`revoked`になり、`status_reason: consent_lapsed`が設定されます。利用者は再度接続する必要があります。

完全なフローについては、[同意を更新する](https://docs.didit.me/ja/use-cases/renew-bank-consent.md)を参照してください。

## アクセスを停止する

| 対象 | 方法 | 結果 |
| - | - | - |
| 本人 | 銀行で **共有を停止** | `bank.connection.revoked` で、`ended_by: end_user` または `bank` が付きます |
| 貴社 | [`revoke_connection`](https://docs.didit.me/ja/standalone-apis/bank-connection-revoke) | 銀行からのデータ取得は直ちに停止します。同意は `revocation_pending` と表示され、銀行が確認した時点で `revoked` になります。すでに読み取られたデータは、接続を削除するか `consent.retain_until` を過ぎるまで閲覧できる状態のままです。 |
| 貴社 | [`delete_connection`](https://docs.didit.me/ja/standalone-apis/bank-connection-delete) | アクセスを停止し、接続とその口座、残高、取引を削除します。取り消しはできません。 |

アクセスの停止は、削除とは異なります。
削除によって何が消えるかは、[データ、同意、削除](https://docs.didit.me/ja/core-technology/bank-verification/data-consent-and-deletion.md)をご覧ください。

## 削除された接続

削除された接続で返されるのは、`id`、`status`（`deleted`）、`status_reason`、`created_at`、`erasure` のみです。
`status_reason` の値は、`deleted_by_customer`、`consent_lapsed`、`retention_elapsed`、`application_deleted` のいずれかです。
それ以外のフィールドは含まれません。

## 重複

同じ`end_user.reference`で、同じ銀行において既存の連携先アカウントと正確に一致するアカウントに解決される新しい認証リンクは、そのコネクションの更新として完了し(`reused: true`)、料金が二重に請求されることはありません。

それ以外の重複がある場合、保存や課金が行われる前に、認証リンクは`failed`で終了し、`duplicate_conflict`と`conflicts_with`が返されます。

既存のコネクションを更新するか、独立した2つ目のコネクションを作成する場合は、`"duplicates": "allow"`を指定して認証リンクを作成し直してください。

## 顧客の接続を管理する

* フィルターによる一覧表示: [`GET /v3/bank/connections/`](https://docs.didit.me/ja/standalone-apis/bank-connections-list) では、`status`、`access`、`institution_id`、`country`、`vendor_data`、`end_user_reference`、`consent_expires_before`、`created_after` でフィルターできます。
* `billing` オブジェクトで接続の料金を確認できます。単位、料金、すでに精算済みの月が含まれます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.