Primagest Trust Services
プロダクト
ドキュメント
運営会社
プロダクト
ドキュメント
運営会社
APIリファレンス
お問い合わせ
同意
ようこそ
本人確認
公的個人認証
署名API
利用者証明API
カード代替電磁的記録
スマートフォンのマイナンバーカードAPI
ICチップ読み取り
マイナンバーカード券面API
マイナンバーカード券面事項入力補助API
運転免許証API
在留カードAPI
特別永住者証明書API
ICチップ読み取り+容貌撮影
証跡
証跡照会API
基本4情報提供
同意
同意取得API
同意取消しAPI
同意状況照会API
失効情報
失効情報確認API
失効情報通知API
基本4情報提供
基本4情報提供API
基本4情報自動最新化API
デジタル認証アプリ
デジタル認証アプリ 署名API
デジタル認証アプ リ 認証API
デジタル認証アプリ 同意取得API
デジタル認証アプリ 同意取消しAPI
SDK
iOS
Android
React Native
Windows
同意
同意取得API
概要
#
同意取得APIは、利用者の基本4情報(氏名・住所・生年月日・性別)の提供を受けるために必要となる同意を取得するためのAPIです。利用者からの同意は、本人の意思に基づくものであることを確実に示すため、署名用電子証明書を用います。署名用電子証明書を用いた同意は、サービスプロバイダ事業者とプラットフォーム事業者を経由しJ-LISに送信されます。各事業者及びJ-LISは、それぞれ同意情報に関するデータベース等を構築し、保存・管理を行います。
アクセスコントロール
#
マイナンバーカード
スマートフォンのマイナンバーカード
処理の流れ
#
対面
非対面
1
利用者から同意取得(サービスプロバイダ事業者)
利用者から基本4情報(氏名・住所・生年月日・性別)の取得に関する同意を取得します。
2
同意申請書データの作成・送信(サービスプロバイダ事業者)
利用者から同意を取得した後、SDKを使用して利用者のマイナンバーカードまたはスマートフォンのマイナンバーカードを、ICカードリーダーまたはスマートフォンのNFC機能で読み取り、6〜16桁の署名用電子証明書の暗証番号を入力することで、同意申請書データを生成し、APIでリクエストを送信します。
スマートフォンのマイナンバーカード読み取りは、機種ごとに読み取り手順が変わります。
iPhoneのマイナンバーカードを読み取る
Androidスマホ用電子証明書を読み取る
3
同意申請書データの送信(プラットフォーム事業者)
受信した同意申請書データをJ-LISに送信し、利用者の同意を申請します。J-LISは同意データを受信後、署名検証と失効確認を行い、問題がなければ同意結果をプラットフォーム事業者へ返却します。
4
同意結果の取得(プラットフォーム事業者)
同意申請が正常に完了した場合、J-LISから同意結果(受理番号および利用者同意の有効期限)が返却されます。
5
同意結果の保存・返却(プラットフォーム事 業者)
取得した同意結果をデータベースに保管・管理し、サービスプロバイダ事業者へ返却します。また、サービスプロバイダ事業者も同様に、同意結果を自社のデータベースで保管・管理する必要があります。
シーケンス図
#
対面
非対面
実装例
#
iOS
Android
React Native
Windows
前へ
基本4情報提供
次へ
同意取消しAPI