このガイドはMoneytree LINKサービスを利用したWebアプリケーション開発にあたり、第一歩目となるAPIコールで金融データ取得までの手順を説明しています。
以下2つのページをクライアント様ウェブアプリケーションに組み込み、APIコールを行うことで、Moneytree LINKサービスを通じてエンドユーザー様の金融データをクライアント様webアプリケーションに連携することができます。
このスタートガイドでは検証環境でテストアプリを作成し、上記の2つのページを組み込み、最初のAPIコールで金融データを取得する基礎的なシナリオを想定しています。
このガイドと合わせて、簡単なサンプルコードを解説付きで紹介しているチュートリアル（レシピ）も用意しています。ぜひそちらもご覧ください。
Step 0 - セットアップ
Step 1 - OAuthの認可の設定とトークンの取得
Step 2 - 金融サービス一覧ページで金融機関の登録
Step 3 - アクセストークンでAPIコールを行いエンドユーザーの口座データを取得
スタートガイド概要マップ
エンドユーザー：Moneytree LINKクライアントのサービス利用者をエンドユーザーと呼びます。
クライアント：Moneytree LINKのAPIを利用し、エンドユーザーの金融データを取得するアプリやサービスを提供するサービス事業者をクライアントと呼びます。
Moneytree LINK：エンドユーザーから明示的に情報共有の同意を得た上で金融データを取得し、それを集約してクライアントに提供するデータプラットフォームです。
このステップでは検証環境でテストアプリ作成を始める前のセットアップを紹介しています。検証環境は主にMoneytree LINK APIに対して開発・テストするための環境です。Moneytree LINK APIの本番データを取得する環境は本番環境となります。
マネーツリーが検証環境上でclient_id、client_secret、redirect_uriを事前登録していることをご確認ください。ご質問はMonetytree LINKのお問合せフォームをご活用ください。
このガイドではテストアプリ用のredirect_uriをローカルホストに設定したシナリオになります。
例) http://localhost:8080/moneytree_auth/callback
テスト用のエンドユーザーアカウントはご担当者様のメールアドレスなどを使用して作成してください。エンドユーザーアカウントを準備することで、Moneytree LINK サービスを介して、金融データ取得のテストを行うことができます。
エンドユーザーアカウントの新規作成をする場合は、こちらのいずれかの金融機関一覧のURLからアカウント新規登録ができます。
新規登録画面で、ユーザーIDとパスワードを設定してエンドユーザーのMoneytree IDを作成します。
このステップではOAuth認可フローの設定とアクセストークン取得のプロセスを紹介しています
クライアントのテストアプリがエンドユーザーの金融データにアクセスできるように、エンドユーザーが「認可」(連携許可)を承認できる認可フレームワーク(OAuth 2.0)を設定します。
サンプルコードを使ったチュートリアルもご参考ください。
エンドユーザーのフローはテストアプリ画面から始まり、Moneytree IDの連携許可承認画面へと移り、連携許可を承認して、テストアプリ画面へと戻ります。
エンドユーザーはテストアプリ上でMoneytree IDの連携許可承認画面へのリンクをクリックします。
エンドユーザーはメールアドレスとパスワードを入力して、Moneytree IDにログインします。
エンドユーザーはMoneytree IDの連携許可承認画面で、連携許可の承認もしくはキャンセルを選択します。
エンドユーザーは連携許可を承認して、テストアプリで連携許可の完了を確認します。
このステップではエンドユーザーのアカウントで金融の登録を完了するプロセスを紹介しています。
Moneytree LINK サービスは、エンドユーザーが登録した金融機関・サービスから金融データを取得します。エンドユーザーアカウントで、金融サービス一覧ページから1つ以上の金融機関を登録してください。
エンドユーザーのフローは、Moneytree IDにログインして金融サービス一覧画面へと移ります。次に登録したい金融サービスを検索し、必要な情報を入力して登録を完了します。
このガイドでは、検証環境の金融サービス一覧ページで、金融サービス「[Data Test] Bank」の登録を例にしています。
エンドユーザーはメールアドレスとパスワードを入力して、Moneytree IDにログインします。
ログイン後、金融サービス一覧ページに移ります。エンドユーザーは緑色ボタン「銀行を登録する」「クレジットカードを登録する」をクリックするか、右下の「＋」ボタンをクリックして「[Data Test] Bank」を検索します。
エンドユーザーは、金融サービス一覧ページの画面で必要なログイン情報を入力もしくは選択し、「金融機関に接続する」ボタンをクリックします。
金融サービス一覧ページに戻り、接続済みの金融サービスに連携接続中である金融サービスが表示されます。「接続中」から「たった今更新」のステータスが表示されるのを確認できれば登録完了です。
このステップは取得したトークンで最初のAPIコールをしてテストエンドユーザーの口座一覧を取得するプロセスを説明しています
Moneytree LINK はStep 1でエンドユーザーが連携許可の承認をした場合、アクセストークンおよびリフレッシュトークンを生成します。クライアントはそのアクセストークンを使用することでエンドユーザーの金融データへアクセスすることが承認されます。
実使用ではトークンリフレッシュの設定が必要になります。ご興味ある方は、サンプルコードを使ったチュートリアルをご参考ください。
このスタートガイドに併せて、以下のリソースもご参照ください。
サンプルコードを紹介しているチュートリアル（レシピ）
MoneytreeのAPIドキュメントサイトにも開発のリソースを掲載しています。
