2026年春のサービス開始に先駆け事前相談受付中。気軽にお問い合わせください。
Primagest Trust Services
プロダクト
ドキュメント
運営会社
プロダクト
ドキュメント
運営会社
ブログ
APIリファレンス
お問い合わせ
ICチップ読み取り
ようこそ
本人確認
公的個人認証
署名API
利用者証明API
証跡照会API
カード代替電磁的記録
スマートフォンのマイナンバーカードAPI
ICチップ読み取り
マイナンバーカード券面API
マイナンバーカード券面事項入力補助API
運転免許証API
在留カードAPI
特別永住者証明書API
利用者ID
利用者ID発行
利用者ID削除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
次へ
利用者ID発行