このガイドはMoneytree LINKサービスを利用したWebアプリケーション開発にあたり、第一歩目となるAPIコールで金融データ取得までの手順を説明しています。

スタートガイド概要

以下2つのページをクライアント様ウェブアプリケーションに組み込み、APIコールを行うことで、Moneytree LINKサービスを通じてエンドユーザー様の金融データをクライアント様webアプリケーションに連携することができます。

OAuth認可ページ：Moneytree LINKで保持するエンドユーザー様の金融データをクライアント様webアプリケーションへ連携を許可する仕組み
金融サービス一覧ページ：Moneytree LINKに接続する金融機関の追加や削除などを管理するページ

このスタートガイドでは検証環境でテストアプリを作成し、上記の2つのページを組み込み、最初のAPIコールで金融データを取得する基礎的なシナリオを想定しています。

このガイドと合わせて、簡単なサンプルコードを解説付きで紹介しているチュートリアル（レシピ）を用意しています。ぜひそちらもご覧ください。

手順

Step 0- セットアップ

Step 1 - OAuthの認可の設定とトークンの取得

Step 2 - 金融サービス一覧ページで金融機関の登録

Step 3 - アクセストークンでAPIコールを行いエンドユーザーの口座データを取得

スタートガイド概要マップ

エンドユーザー：Moneytree LINKクライアントのサービス利用者をエンドユーザーと呼びます。
クライアント：Moneytree LINKのAPIを利用し、エンドユーザーの金融データを取得するアプリやサービスを提供するサービス事業者をクライアントと呼びます。
Moneytree LINK：エンドユーザーから明示的に情報共有の同意を得た上で金融データを取得し、それを集約してクライアントに提供するデータプラットフォームです。

Step 0 - セットアップ

このステップでは検証環境でテストアプリ作成を始める前のセットアップを紹介しています。検証環境は主にMoneytree LINK APIに対して開発・テストするための環境です。Moneytree LINK APIの本番データを取得する環境は本番環境となります。

認証の照合に使われるclient_idとclient_secretはマネーツリーから提供されます。

このガイドではテストアプリ用のredirect_uriをローカルホストに設定したシナリオになります。
例) http://localhost:8080/moneytree_auth/callback

ご質問はMonetytree LINKのお問合せフォームをご活用ください。

テスト用のエンドユーザーアカウントはご担当者様のメールアドレスなどを使用して作成してください。エンドユーザーアカウントを準備することで、Moneytree LINK サービスを介して、金融データ取得のテストを行うことができます。

テスト用のエンドユーザーとしてMoneytree IDの新規登録を完了します。（新規登録ページ）

エンドユーザーアカウントの新規作成をする場合は、こちらのいずれかの金融機関一覧のURLからアカウント新規登録ができます。

<https://vault-staging.getmoneytree.com?client_id=[******]&configs=auth_action=signup>
（[**]の部分は、Client IDに入れ替えてください。）
<https://vault-staging.getmoneytree.com/?configs=auth_action=signup>

アカウント新規登録

新規登録画面で、ユーザーIDとパスワードを設定してエンドユーザーのMoneytree IDを作成します。

Step 1 - OAuthの認可の設定とトークンの取得

このステップではOAuth認可フローの設定とアクセストークン取得のプロセスを紹介しています

クライアントのテストアプリがエンドユーザーの金融データにアクセスできるように、エンドユーザーが「認可」(連携許可)を承認できる認可フレームワーク(OAuth 2.0)を設定します。

Moneytree LINKのOAuth認可ページ（連携許可承認画面）にリダイレクトされる誘導リンクを、テストアプリウェブサーバーに設定します。実際にはエンドユーザーのクリックでリダイレクトされます。
エンドユーザーは連携許可承認画面でクライアントへの連携許可を承認もしくはキャンセルします。（エンドユーザーがMoneytree IDにログインしていない場合はログイン画面が先に表示されます。
エンドユーザーにより連携許可が承認された場合、Moneytree LINK はブラウザを介して認可コードを含むリダイレクトコールをします。
クライアントのテストアプリは、送られてきた認可コードとclient_idとclient_secretを使いアクセストークンをリクエストします。
Moneytree LINK のバックエンドシステムが認可コード、client_id、client_secretを検証します。
全てが承認された場合、Moneytree LINK はアクセストークンおよびリフレッシュトークンを生成して、クライアントに送ります。