憑證 Schema 目錄

VCT 元資料系統

TCS 中的每個憑證類型都定義為 VCT（Verifiable Credential Type） 元資料記錄。Schema Registry 儲存這些定義，並透過探索端點公開。

每筆 VCT 記錄包含：

欄位	說明
credentialType	憑證類型的唯一識別符（例如 UniversityDegreeCredential）
version	Schema 版本（例如 v1、v2）
status	生命週期狀態（例如 active）
useCase	描述使用情境的選填標籤（例如 identity_verification、kyc）
schema	定義憑證主體必填和選填欄位的 JSON Schema

探索端點：

GET https://schema-registry.turingspace.co/schemas/{credentialType}/{version}

回傳指定憑證類型和版本的完整 VCT 元資料，包含驗證器和錢包用來解讀憑證的 JSON Schema。

---

平台

TuringCerts 標準憑證

具有較嚴格欄位要求的通用憑證。

• credentialType: TuringCerts_Standard_Credential
• version: v2

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
expiredTime	string (date-time)	否

TuringCerts 標準 KYC 憑證

含必填核心身份欄位的身份驗證憑證。

• credentialType: TuringCerts_Standard_KYCCredential
• version: v2

欄位	類型	必填
credentialName	string	是
issuerName	string	是
documentNumber	string	是
issuedTime	string (date-time)	是
dob	string (date-time)	是
nationality	string	否
expiredTime	string (date-time)	否
gender	string	否
address	string	否

---

身份

護照憑證

包含持有者身份、國籍、文件號碼和有效期的數位護照記錄。

• credentialType: PassportCredential
• version: v1
• 使用情境: identity_verification、kyc、border_control

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
fullName	string	是
documentNumber	string	是
countryIso2	string	是
dateOfBirth	string (date)	是
sex	string	是
expiredTime	string (date-time)	否
fullNameLocal	string	否
idNumber	string	否
documentType	string	否
countryFull	string	否
placeOfBirth	string	否
issueAuthority	string	否

身分證憑證

包含持有者身份、文件號碼和出生地的國家身分證。

• credentialType: IdentityCardCredential
• version: v1
• 使用情境: identity_verification、kyc、age_verification

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
fullName	string	是
documentNumber	string	是
countryIso2	string	是
dateOfBirth	string (date)	是
issueAuthority	string	是
expiredTime	string (date-time)	否
documentType	string	否
countryFull	string	否
placeOfBirth	string	否

駕照憑證

包含持有者身份、車輛類別和文件號碼的駕照。

• credentialType: DriversLicenseCredential
• version: v1
• 使用情境: identity_verification、kyc、age_verification

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
fullName	string	是
documentNumber	string	是
countryIso2	string	是
dateOfBirth	string (date)	是
expiredTime	string (date-time)	否
sex	string	否
documentType	string	否
countryFull	string	否
vehicleClass	string	否

真人驗證憑證

證明受驗者已通過核准發行方的真人驗證程序。

• credentialType: ProofOfHumanCredential
• version: v1
• 使用情境: proof_of_human、anti_sybil、bot_prevention、eligibility_check

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
humancheck	boolean	是
subjectId	string	是
expiredTime	string (date-time)	否
assuranceLevel	string	否
verificationMethod	string	否
verifiedAt	string (date-time)	否
evidenceReference	string	否

ISO/IEC TS 23220-4 Photo ID

依 ISO/IEC TS 23220-4:2026 Annex C 定義的國際 Photo ID profile。HAIP-conformant 錢包（如 EUDI Wallet、DNP × Meeco CATRINA v3.5 profile）會用這個。以 dc+sd-jwt 發行，vct 為不含 URL 形式的 reverse-domain 字串 org.iso.23220.photoid.1 — 錢包與 verifier 都用這個字串精確比對。Claims 分散在兩個 ISO namespace（org.iso.23220.1 是核心身分、org.iso.23220.photoid.1 是 photo ID 專屬擴充），都裝在同一張 SD-JWT 裡。必填集合是 Annex C 規定的 9 個強制資料元素。

• credentialType： org.iso.23220.photoid.1
• vct： org.iso.23220.photoid.1（bare reverse-domain — 沒有 URL 形式）
• version： v1
• configId： org_iso_23220_photoid_1_v1_sd_jwt（小數點轉成底線）
• 使用情境： photoid、travel、catrina、identity_verification

必填欄位（namespace org.iso.23220.1，9 個全必填）

欄位	類型	備註
family_name_unicode	string	UTF-8 姓
given_name_unicode	string	UTF-8 名
birth_date	string (date)	YYYY-MM-DD
portrait	string	Base64URL 的 JPEG/PNG，原始檔 ≤ ~5 MB
issue_date	string (date)	YYYY-MM-DD
expiry_date	string (date)	YYYY-MM-DD
issuing_authority_unicode	string	UTF-8 發行機構
issuing_country	string	ISO 3166-1 alpha-2、大寫
age_over_18	boolean	適合 selective disclosure 的年齡檢查

選填欄位（namespace org.iso.23220.1）

欄位	類型	備註
sex	integer	ISO/IEC 5218：0 不詳、1 男、2 女、9 不適用
nationality	string	ISO 3166-1 alpha-2
document_number	string
name_at_birth	string
birthplace	string
portrait_capture_date	string (date)
resident_address_unicode	string
resident_city_unicode	string
resident_postal_code	string
resident_country	string	ISO 3166-1 alpha-2
age_in_years	integer	0–150
age_birth_year	integer	1900–2100
family_name_latin1	string	Latin-1 轉寫
given_name_latin1	string	Latin-1 轉寫

選填欄位（namespace org.iso.23220.photoid.1）

欄位	類型	備註
person_id	string
birth_country	string	ISO 3166-1 alpha-2
birth_state	string
birth_city	string
administrative_number	string
resident_street	string
resident_house_number	string
travel_document_number	string
resident_state	string

這個 VCT 的簽章路徑只走 HAIP：ES256 + P-256 leaf + x5c 鏈、且 header 不可同時帶 kid。不接受 EdDSA / DID 簽章 — 信任錨點切割細節請見架構與安全性。

---

教育

大學學位憑證

證明大學或高等教育機構授予的學術學位。

• credentialType: UniversityDegreeCredential
• version: v1
• 使用情境: academic_verification、kyc、job_application

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
studentId	string	是
degreeName	string	是
achievementDate	string (date)	是
expiredTime	string (date-time)	否
departmentName	string	否

學術成績單憑證

包含個別課程成績、學分數和累積 GPA 的官方學術記錄。

• credentialType: AcademicTranscriptCredential
• version: v1
• 使用情境: academic_verification、job_application

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
studentId	string	是
courses	array of objects (name, grade, credits)	是
gpa	number	是
expiredTime	string (date-time)	否
transcriptId	string	否

學生證憑證

驗證在籍狀態和學術課程的數位學生識別證。

• credentialType: StudentIDCredential
• version: v1
• 使用情境: identity_verification、age_verification、student_discount

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
studentId	string	是
enrollmentStatus	string	是
program	string	是
name	string	是
expiredTime	string (date-time)	否

課程完成憑證

確認持有者已完成特定課程或培訓計畫。

• credentialType: CourseCompletion
• version: v1
• 使用情境: academic_verification、professional_qualification、corporate_compliance

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
name	string	是
courseName	string	是
completionDate	string	是
expiredTime	string (date-time)	否
certNumber	string	否
idNumber	string	否
periodHours	string	否

獎狀憑證

表彰成就或榮譽，例如獎學金、競賽獎項或學術殊榮。

• credentialType: Award
• version: v1
• 使用情境: academic_verification、job_application

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
name	string	是
expiredTime	string (date-time)	否
nameEn	string	否
recipientId	string	否

---

專業

員工憑證

驗證組織內職位、部門和到職日期的數位員工識別證。

• credentialType: EmployeeCredential
• version: v1
• 使用情境: identity_verification、corporate_compliance、access_control

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
employeeId	string	是
position	string	是
department	string	是
startDate	string (date)	是
name	string	是
expiredTime	string (date-time)	否
idNumber	string	否

專業憑證

證明持有者在特定領域持有有效的專業認證。

• credentialType: ProfessionalCredential
• version: v1
• 使用情境: professional_qualification、kyc、job_application

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
certificationName	string	是
professionalField	string	是
issuingAuthority	string	是
name	string	是
expiredTime	string (date-time)	否
certificationNumber	string	否
idNumber	string	否

認證考試憑證

證明持有者通過了認證或執照考試。

• credentialType: CertificationExam
• version: v1
• 使用情境: professional_qualification、kyc

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
name	string	是
grade	string	是
idNumber	string	是
certNumber	string	是
examDatetime	string (date-time)	否
expiredTime	string (date-time)	否
dateOfBirth	string	否
examName	string	否

培訓證書

在完成職業或技職培訓計畫後發行。

• credentialType: TrainingCertificate
• version: v1
• 使用情境: professional_qualification、corporate_compliance

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
name	string	是
instructorName	string	是
trainingOrg	string	是
certNumber	string	是
expiredTime	string (date-time)	否
nameEn	string	否
instructorEn	string	否
trainingOrgEn	string	否

醫療執照憑證

證明醫療專業人員持有有效的執業執照。

• credentialType: MedicalLicenseCredential
• version: v1
• 使用情境: professional_qualification、kyc、medical_compliance

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
licenseType	string	是
issuingAuthority	string	是
name	string	是
dateOfBirth	string (date)	是
idNumber	string	是
expiredTime	string (date-time)	否
licenseNumber	string	否

---

醫療

疫苗接種證明

記錄疫苗接種資訊，包含疫苗名稱、接種日期和劑次資訊。

• credentialType: VaccinationCertificate
• version: v1
• 使用情境: health_verification、border_control、corporate_compliance

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
vaccineName	string	是
countryOfVaccination	string	是
dateAdministered	string (date)	是
name	string	是
dateOfBirth	string (date)	是
idNumber	string	是
expiredTime	string (date-time)	否
doseNumber	integer	否
manufacturer	string	否
lotNumber	string	否

健康檢查憑證

記錄職業健康或一般健康檢查的結果。

• credentialType: HealthCheck
• version: v1
• 使用情境: corporate_compliance、occupational_safety

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
name	string	是
companyName	string	是
dateOfBirth	string	是
healthCheckDate	string	是
jobTitle	string	否
expiredTime	string (date-time)	否
dobLabel	string	否
vo2max	string	否

---

金融

保險理賠憑證

代表已驗證的保險理賠記錄，包含理賠號碼、金額和日期。

• credentialType: InsuranceClaimCredential
• version: v1
• 使用情境: financial_verification、insurance_claim

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
claimNumber	string	是
claimDate	string (date)	是
name	string	是
dateOfBirth	string (date)	是
idNumber	string	是
expiredTime	string (date-time)	否
claimOrganization	string	否
claimCategory	string	否
amount	number	否

---

門禁

門禁卡憑證

包含允許區域和門禁層級的實體場所數位門禁卡。

• credentialType: AccessCardCredential
• version: v1
• 使用情境: access_control、identity_verification

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
accessCardId	string	是
locations	array of strings	是
accessLevel	string	是
name	string	是
expiredTime	string (date-time)	否
holderId	string	否

會員憑證

證明在某組織或協會的有效會員資格。

• credentialType: MembershipCredential
• version: v1
• 使用情境: identity_verification、member_benefit

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
membershipId	string	是
membershipType	string	是
joinDate	string (date)	是
membershipOrganization	string	是
name	string	是
expiredTime	string (date-time)	否
membershipStatus	string	否
membershipLevel	string	否
dateOfBirth	string (date)	否

活動門票憑證

音樂會、研討會或展覽的數位門票，包含座位指定和入場 QR Code。

• credentialType: EventTicketCredential
• version: v1
• 使用情境: ticket_verification、age_verification

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
event	string	是
eventDate	string (date)	是
ticketID	string	是
expiredTime	string (date-time)	否
eventOrganizer	string	否
status	string	否
ticketCategory	string	否
seat	string	否
qrCode	string	否
name	string	否

---

人道主義

難民身份憑證

由發行機構（例如 UNHCR）認可的難民身份證明。

• credentialType: RefugeeStatusCredential
• version: v1
• 使用情境: identity_verification、humanitarian_aid、social_welfare

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
issuingAuthority	string	是
name	string	是
dateOfBirth	string (date)	是
idNumber	string	是
gender	string	是
nationality	string	是
expiredTime	string (date-time)	否

身心障礙狀態憑證

證明持有者的已登記身心障礙狀態，用於申請社會福利和無障礙服務。

• credentialType: DisabilityStatusCredential
• version: v1
• 使用情境: identity_verification、social_welfare、accessibility_service

欄位	類型	必填
credentialName	string	是
issuedTime	string (date-time)	是
disabilityType	string	是
effectiveDate	string (date)	是
severity	string	是
name	string	是
dateOfBirth	string (date)	是
idNumber	string	是
expiredTime	string (date-time)	否
reassessmentDate	string (date)	否
issuingAuthority	string	否

---

下一步

• 信任與 Schema 治理 — 註冊你的組織並探索 Schema
• 發行憑證 — 使用你的 API 金鑰和 DID 發行 SD-JWT 憑證