はじめに

完成イメージ: https://widget.wealthreader.com/demo-all/

始める前に

次の準備が必要です。

• 登録を完了し、api_key を取得する。
• 技術チームとのオンボーディングに参加する。サポートから予約してください。
• 連携方式を選ぶ（下記参照）。
• iframe 方式の場合は、callback を受信する HTTPS URL を用意する。

連携方式を選ぶ

多くの Web アプリは iframe 方式を使用します。

動作の流れ（iframe）

1. 自分で生成した operation_id を指定して、ページにウィジェットを読み込みます。
2. ユーザーが銀行を選び、同意し、必要なら二要素認証を行います。これらの手順はウィジェットが管理します。
3. Wealth Reader はデータを取得し、次の順番で 2 つの処理を行います。
   • バックエンドには、設定済みの callback URL へ完全な JSON を送信します。応答に含まれる operation_id により、フロントエンドの操作と関連付けられます。
   • フロントエンドには、callback が正常に応答した場合に限り、iframe が postMessage（flow completed）で通知します。この通知で選択画面を閉じるか、成功画面を表示します。

operation_id はフロントエンドとバックエンドを結ぶ識別子です。これがなければ、ブラウザー上の操作とサーバーに届くデータを関連付けられません。