本APIを利用することで、利用者に公的個人認証を要求し、マイナンバーカードの利用者証明用電子証明書に紐付けられたシリアル番号の提供を利用者にリクエストすることができます。また、プロセスの最初に、利用者の署名用電子証明書の失効確認を行います。その結果、無効であった場合は、その旨が応答され、プロセスは終了します。本人確認情報更新APIを用いるなどして、本人確認情報の更新を利用者に促してください。シリアル番号をはじめとする本プロセスにおいて取得されたデータはxIDには保管されず、一度クライアント側から取得されると即座に削除されます。クライアント側にて適切に管理保管してください 。
Serialについて#
シーケンス#
利用者フロー#
SerialCallbackについて#
Serialとの違い#
本エンドポイントを用いてSerialが開始された場合、自動的にxIDアプリへ遷移してプロセスが開始されます。
当プロセスが完了した後、本要求を実行したサービスに自動的に戻ります
callback_urlに指定することをご検討ください。リクエスト元からxIDアプリへの自動遷移#
レスポンスに含まれるredirect_urlを呼び出していただくことで、xIDアプリに自動遷移しSerialプロセスが開始されます。xIDアプリからリクエスト元への自動遷移#
Serialのプロセス終了後は、リクエスト時に指定されたURLへ自動遷移いたします。その際、当該手続きのステータス（certificate_verified, certificate_invalid, removed）が付与されるので、ステータスに応じてリクエスト元でクライアントに表示する画面を制御することができます。シーケンス#
利用者フロー#
