全部产品
Search
文档中心

ID Verification:Web SDK 自定义语种

更新时间:Aug 15, 2025

ID Verification Web SDK提供多语言自定义配置,开发者可以通过编写配置传入Initialize接口,来实现国际化的多语言。

概述

ID Verification Web SDK提供了多语言的能力,同时支持移动端(Mobile)和桌面端(PC)。

自定义语种需要编写配置文件,并通过Initialize接口的LanguageConfig字段传入。

重要

LanguageConfig字段设置为空,系统会自动识别设备设置的语种自适应匹配,若匹配失败默认展示英文。

已支持语种

重要

目前如下语种仅适配移动端(Mobile)集成模式。

PC端仅支持简体中文、繁体中文和英文,其他语种暂不支持。

语言

code

备注

简体中文

zh

简体中文

繁体中文

TW

繁體中文

英文

en

English

马来西亚语

ms

Bahasa Melayu

印尼语

id

Bahasa Indonesia

泰国语

th

ภาษาไทย

越南语

vi

Tiếng Việt

日语

ja

日本語

韩语

ko

한국어

法语

fr

Français

西班牙语

es

Español

葡萄牙语

pt

Português

俄语

ru

Русский

阿拉伯语

ar

العربية

如何配置默认语种

您可以通过 defaultLanguage 字段指定默认语种,值取对应语种的 code

例如指定默认语种是英文,则LanguageConfig字段:

{
  "defaultLanguage": "en"
}

如何新增语种

由于ID Verification 涉及文案较多,为了避免自定义设置带来的兼容性体验受损,将不再支持自定义新增语种(历史自定义新增语种不受影响)。

若您的业务有新的语种适配需求,您可以通过工单或者商务经理反馈,进行统一适配。

语种设置优先级说明

ID Verification Web SDK (Mobile)页面提供终端用户语种切换功能,设置的优先级如下:

  • 页面显示语种切换按钮:终端用户主动切换的语种 > defaultLanguage > 系统设置语种(产品支持的语种)

  • 页面隐藏语种切换按钮:defaultLanguage > 系统设置语种 (产品支持的语种)

OCR识别结果展示与编辑页面语种说明

ID Verification 卡证模块提供了可选OCR识别结果展示与编辑页面,由于该页面涉及通用操作文案证件卡面原生字段的两种种类文案,产品基于体验一致性进行了如下限制:

说明
  • 通用操作文案:指识别页面中的字段,如按钮、导航等文案。

  • 证件卡面原生字段:指识别出的证件字段,如姓名、性别、住址、宗教等。

  1. eKYCID_OCR 方案支持7种证件类型,该页面多语种仅适配通用操作文案

    • 证件卡面原生字段仅支持中文、繁体中文和英文。

    • defaultLanguage设置为卡面原生字段KEY不支持的语种时,原生字段KEY默认展示英文。

  2. eKYC_PRO 支持全球多种卡证类型识别结果的展示,该页面多语种仅适配通用操作文案

    • 证件卡面原生字段基于固定规则展示。

    • 证件卡面原生字段只有一种语种,字段优先展示卡面语种。

    • 证件卡面原生字段存在英文时,字段优先展示英文。