サービス開始に先駆け事前相談受付中。気軽にお問い合わせください。
Primagest Trust Services
プロダクト
ドキュメント
運営会社
プロダクト
ドキュメント
運営会社
APIリファレンス
お問い合わせ
ICチップ読み取り
ようこそ
本人確認
公的個人認証
署名API
利用者証明API
カード代替電磁的記録
スマートフォンのマイナンバーカードAPI
ICチップ読み取り
マイナンバーカード券面API
マイナンバーカード券面事項入力補助API
運転免許証API
在留カードAPI
特別永住者証明書API
ICチップ読み取り+容貌撮影
利用者ID
利用者ID発行
利用者ID削除API
証跡
証跡照会API
基本4情報提供
同意
同意取得API
同意取消しAPI
同意状況照会API
失効情報
失効情報確認API
失効情報通知API
基本4情報提供
基本4情報提供API
基本4情報自動最新化API
デジタル認証アプリ
デジタル認証アプリ 署名API
デジタル認証アプリ 認証API
デジタ ル認証アプリ 同意取得API
デジタル認証アプリ 同意取消しAPI
SDK
iOS
Android
React Native
Windows
ICチップ読み取り
特別永住者証明書API
概要
#
特別永住者証明書APIは、特別永住者証明書または特定特別永住者証明書のICチップを読み取るためのAPIです。
特別永住者証明書または特定特別永住者証明書に記載されている12桁の特別永住者証明書番号を入力することで、特別永住者証明書または特定特別永住者証明書の情報を全て取得します(取得項目は選択可能です)。また、特別永住者証明書に格納されているチェックコードを検証することで真贋判定を行い、有効期限満了日と当日の日時を比較することで、有効性確認も同時に行います。真贋および有効性確認後、特別永住者証明書または特定特別永住者証明書 の情報を取得できます。
注意
特別永住者証明書には、第1世代または第2世代の2種類が存在し、一部の取得項目が異なります。各特別永住者証明書の取得項目につきましては、「第1世代特別永住者証明書の取得項目」および「第2世代特別永住者証明書の取得項目」をご覧ください。
第1世代特別永住者証明書の取得項目
第2世代特別永住者証明書の取得項目
特定特別永住者証明書の取得項目
アクセスコントロール
#
特別永住者証明書情報の取得
特定特別永住者証明書情報の取得
処理の流 れ
#
対面
非対面
1
特別永住者証明書・特定特別永住者証明書のデータ取得(サービスプロバイダ事業者)
SDKを利用して特別永住者証明書または特定特別永住者証明書のICチップを読み取り、利用者が入力した特別永住者証明書番号または特定特別永住者証明書番号を利用することで、特別永住者証明書または特定特別永住者証明書のデータを取得します。取得したデータは、署名検証・有効性確認・利用できる形式への変換を行うために、専用のAPIで送信します。
2
特別永住者証明書・特定特別永住者証明書の署名検証・有効性確認(プラットフォーム事業者)
APIで送信されたデータより、電子署名を取得し、署名検証による真贋判定を行います。署名検証後は、特別永住者証明書または特定特別永住者証明書の有効期限満了日と当日の日付を比較することで、有効性確認を行います。第一世代の特別永住者証明書に限り、券面イメージ内の有効期限満了日を抽出し、そちらを照合するため、抽出失敗時はエラーを返却します。
紛失、出国済み、在留資格の取消しなど、失効理由を確認される場合は、出入国在留管理庁の提供する「
在留カード等番号失効情報照会
」を別途ご利用ください。
3
特別永住者証明書情報・特定特別永住者証明書の情報取得(プラットフォーム事業者)
署名検証および有効性確認後、特別永住者証明書または特定特 別永住者証明書の情報を利用できる形式へ変換し、サービスプロバイダ事業者へ返却します。取得項目を選択している場合は、対象の項目のみ返却されます。
シーケンス図
#
対面
非対面
実装例
#
iOS
Android
React Native
Windows
前へ
在留カードAPI
次へ
ICチップ読み取り+容貌撮影