Primagest Trust Services
プロダクトドキュメント
運営会社
プロダクトドキュメント
運営会社
APIリファレンス
  1. 同意
  • ようこそ
  • 本人確認
    • 公的個人認証
      • 署名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
  1. 同意

同意取得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
Built with