HitechCloud
VI EN
Tài liệu VNeIDEKYC

VNeIDEKYC

16 endpoint trong nhóm này.

GET Start Personal eKYC
/api/vneidekyc/ekyc/session

Create or fetch an active personal eKYC session for the given client_id.

GET Get eKYC Session
/api/vneidekyc/ekyc/session/{session_hash}

Read session status, face_match, liveness, score.

GET List Client eKYC Sessions
/api/vneidekyc/ekyc/list/{client_id}

Recent eKYC sessions for a client (limit, default 10).

POST Upload eKYC File
/api/vneidekyc/ekyc/{session_hash}/upload

Upload CCCD/selfie file to VNeID + persist to module storage.

POST Submit eKYC
/api/vneidekyc/ekyc/{session_hash}/submit

Submit all files to VNeID ekyc endpoint with personInfo.

POST Cancel eKYC Session
/api/vneidekyc/ekyc/{session_hash}/cancel

Mark the current eKYC session as cancelled (client-only).

POST Admin: Accept eKYC
/api/vneidekyc/ekyc/{session_hash}/accept

Mark the eKYC session accepted (admin only).

POST Admin: Reject eKYC
/api/vneidekyc/ekyc/{session_hash}/reject

Mark the eKYC session rejected (admin only). rejection_reason required.

POST Organization Tax Code Lookup
/api/vneidekyc/org/lookup

Look up an organization by tax_code via VNeID. No client ownership required.

POST Start Organization Verification
/api/vneidekyc/org/start

Begin organization verification. Returns org_hash, status=pdf_required.

GET Get Organization
/api/vneidekyc/org/{org_hash}

Fetch organization record by org_hash.

POST Admin: Accept Organization
/api/vneidekyc/org/{org_hash}/accept

Mark the organization accepted (admin only).

POST Admin: Reject Organization
/api/vneidekyc/org/{org_hash}/reject

Mark the organization rejected (admin only). rejection_reason required.

POST Upload Signed PDF
/api/vneidekyc/pdf/upload

Upload a signed PDF, verify signature against VN root CA whitelist, persist result.

GET Get Signed PDF
/api/vneidekyc/pdf/{pdf_hash}

Fetch PDF document record (no raw file).

GET Client Verification Status
/api/vneidekyc/client/{client_id}/status

Aggregated status: is_personal_verified, has_organization_accepted, recent sessions, orgs, pdfs.