Moneytree LINK ロゴ

開発スタートガイド

開発スタートガイド

このガイドは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:エンドユーザーから明示的に情報共有の同意を得た上で金融データを取得し、それを集約してクライアントに提供するデータプラットフォームです。

Step 0 - セットアップ

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

マネーツリーが検証環境上でclient_id、client_secret、redirect_uriを事前登録していることをご確認ください。ご質問はMonetytree LINKのお問合せフォームをご活用ください。

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

開発スタートガイド クライアント・Moneytree LINK セットアップ図

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

エンドユーザー Moneytree ID 新規登録図

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

Moneytree ID 新規登録スクリーンショット

アカウント新規登録

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

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

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

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

サンプルコードを使ったチュートリアルもご参考ください。

開発スタートガイド OAuth認可マップ図

エンドユーザーのフローはテストアプリ画面から始まり、Moneytree IDの連携許可承認画面へと移り、連携許可を承認して、テストアプリ画面へと戻ります。

テストアプリ 連携開始スクリーンショット
エンドユーザーフロー 1

連携許可のプロセスを開始

エンドユーザーはテストアプリ上でMoneytree IDの連携許可承認画面へのリンクをクリックします。

Moneytree ID ログインスクリーンショット
エンドユーザーフロー 2

Moneytree IDにログイン

エンドユーザーはメールアドレスとパスワードを入力して、Moneytree IDにログインします。

Moneytree ID 連携許可スクリーンショット
エンドユーザーフロー 3

連携許可の承認

エンドユーザーはMoneytree IDの連携許可承認画面で、連携許可の承認もしくはキャンセルを選択します。

テストアプリ 連携許可完了スクリーンショット
エンドユーザーフロー 4

連携許可の完了

エンドユーザーは連携許可を承認して、テストアプリで連携許可の完了を確認します。

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

このステップではエンドユーザーのアカウントで金融の登録を完了するプロセスを紹介しています。

Moneytree LINK サービスは、エンドユーザーが登録した金融機関・サービスから金融データを取得します。エンドユーザーアカウントで、金融サービス一覧ページから1つ以上の金融機関を登録してください。

金融機関登録マップ図

エンドユーザーのフローは、Moneytree IDにログインして金融サービス一覧画面へと移ります。次に登録したい金融サービスを検索し、必要な情報を入力して登録を完了します。

このガイドでは、検証環境の金融サービス一覧ページで、金融サービス「[Data Test] Bank」の登録を例にしています。

Moneytree ID ログインスクリーンショット
エンドユーザーフロー 1

Moneytree IDにログイン

エンドユーザーはメールアドレスとパスワードを入力して、Moneytree IDにログインします。

Moneytree 金融サービス一覧スクリーンショット
エンドユーザーフロー 2

金融サービス検索

ログイン後、金融サービス一覧ページに移ります。エンドユーザーは緑色ボタン「銀行を登録する」「クレジットカードを登録する」をクリックするか、右下の「+」ボタンをクリックして「[Data Test] Bank」を検索します。

Moneytree LINK 金融サービス登録スクリーンショット
エンドユーザーフロー 3

金融サービス登録

エンドユーザーは、金融サービス一覧ページの画面で必要なログイン情報を入力もしくは選択し、「金融機関に接続する」ボタンをクリックします。

Moneytree 金融サービス登録完了
エンドユーザーフロー 4

金融サービス登録完了

金融サービス一覧ページに戻り、接続済みの金融サービスに連携接続中である金融サービスが表示されます。「接続中」から「たった今更新」のステータスが表示されるのを確認できれば登録完了です。

Step 3 - APIコールを行い口座一覧を取得する

このステップは取得したトークンで最初のAPIコールをしてテストエンドユーザーの口座一覧を取得するプロセスを説明しています

Moneytree LINK はStep 1でエンドユーザーが連携許可の承認をした場合、アクセストークンおよびリフレッシュトークンを生成します。クライアントはそのアクセストークンを使用することでエンドユーザーの金融データへアクセスすることが承認されます。

実使用ではトークンリフレッシュの設定が必要になります。ご興味ある方は、サンプルコードを使ったチュートリアルをご参考ください。

Moneytree LINK APIコールマップ図

リソース

このスタートガイドに併せて、以下のリソースもご参照ください。

サンプルコードを紹介しているチュートリアル(レシピ)

MoneytreeのAPIドキュメントサイトにも開発のリソースを掲載しています。