メインコンテンツへスキップ
POST
curl
以前のリンクが使えなくなった場合、つまりセッションが削除された場合、または本人が開始する前に期限切れになった場合に使用します。削除されたセッションは、本人がすでに認証を開始または完了していても対象になります。インポートされたセッションは期限切れでは対象にならず、削除されている必要があります。削除されておらず、本人がすでに開始していたセッションは、期限切れでは対象になりません。 新しいセッションは同じ当事者に紐付けられるため、その結果は元のセッションと同様に主要人物のチェックに反映されます。また、そのリンクの有効期間は、企業セッションではなく、実行するKYCワークフローのセッション有効期限(1時間から4週間)に従います。当事者とその子セッションは企業セッションの判定で確認できます。その人物を認証する必要がまったくない場合は、代わりに当事者をスキップしてください。当事者とその認証の仕組みについては、主要人物を参照してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

sessionId
string<uuid>
必須

親となる法人確認 (KYB) セッションのUUIDです。

例:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
必須

主要人物の当事者のUUID (法人セッションの判定内のkey_people_checks[].submitted.parties[].uuid) です。sessionIdで参照されるセッションに属している必要があります。

例:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

レスポンス

新しいKYCセッションが作成されました。新しい子セッションを含む更新後のパーティーを返します。この子セッションは、そのKYCワークフローに設定されたセッション有効期限が経過すると期限切れになります。

法人確認 (KYB)セッションの主要人物の当事者と、その子検証。同じ当事者は、企業セッションの判定のkey_people_checks[].submitted.parties[]にも含まれます。

uuid
string<uuid>
必須

関係者の識別子。

entity_type
enum<string>
必須

当事者が個人か企業か。

利用可能なオプション:
person,
company
source
enum<string>
必須

REGISTRY:法人登記から取得したものです。USER:主要人物画面で入力したものです。

利用可能なオプション:
REGISTRY,
USER
name
string
必須

当事者の表示名です。

is_active
boolean
必須

当事者が有効かどうか。

is_skipped
boolean
必須

当事者が検証を免除されているかどうか。再生成するとクリアされます。

requires_verification
boolean
必須

役割と所有構造のルールにより、この当事者の検証が必要かどうか。

roles
object[]
必須

当事者が企業内で持つ役割。

kyc_session_deleted
boolean
必須

子KYCセッションが削除されたため、確定することはありません。

kyb_sub_session_deleted
boolean
必須

kyc_session_deletedの法人当事者版。

first_name
string | null

名(個人)。

last_name
string | null

姓(個人)。

company_name
string | null

会社名(企業の当事者)。

registration_number
string | null

会社の登記番号(企業の当事者)。

email
string<email> | null

認証リンクの送信先メールアドレス。

nationality
string | null

個人の場合は国籍、企業の場合は設立国。

phone_number
string | null

当事者について収集された電話番号。

date_of_birth
string<date> | null

生年月日(個人)。

position
string | null

自由記述の役職(個人)。

custom_fields
object

当事者について収集された、ワークフローで定義されたカスタムフィールド。フィールドキーをキーとします。

kyc_session_id
string<uuid> | null

個人向けの子KYCセッション(個人)。

kyc_session_status
enum<string> | null

子KYCセッションのステータスです。削除されたセッションは、削除時点のステータスを保持します。

利用可能なオプション:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

子KYCセッションのホスト型リンクです。セッションが存在しない場合や削除された場合、およびsessions: writeを持たないスコープ付きAPIキーの場合はnullです。

kyb_sub_session_id
string<uuid> | null

子KYBセッション(法人の当事者)。

kyb_sub_session_status
enum<string> | null

子KYBセッションのステータス。

利用可能なオプション:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

子KYBセッションのホスト型リンクです。nullになる条件はkyc_session_urlと同じです。

verification_workflow_type
enum<string> | null

子セッションが実行するワークフローの種類。

利用可能なオプション:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

子セッションが実行するワークフロー。

verification_workflow_label
string | null

そのワークフローのラベル。

verification_workflow_features
object[] | null

子セッションのワークフローに含まれる機能と、その現在のステータスです。

didit_internal_id
string<uuid> | null

認証された人物のDidit識別子です(判明した時点で設定されます)。

最終更新日 2026年11月1日