Primagest Trust Services (PTS)
プロダクトドキュメント
運営会社
プロダクトドキュメント
運営会社
APIリファレンス
  1. 同意
  • ようこそ
  • 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
  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