数字身份钱包验证 API 与支持范围

钱包登录是三种身份证件验证方法之一。用户使用其已持有的数字身份（国家 eID 或银行身份）登录，且该提供商会与 Didit 共享一组经签名的属性。结果带有保障等级 cryptographic：身份提供商对该用户进行了认证，并对其返回的属性进行了签名。这就是该等级所声明的全部内容。它并不是相对于另外两个等级的高低排序——它们描述的是不同的证据，而非同一事物的多与少——且登录耗时取决于钱包自身的流程，Didit 既无法控制也无法做出承诺。

可用性取决于您的具体环境。 下方的表格描述了生产环境可用性，且控制台在您保存工作流时会使用其环境的实时能力目录。 MitID、BankID Sweden、iDIN、Finnish Trust Network、Smart-ID 和 Mobile-ID 可用。 Estonian ID-card、eParaksts mobile、Personalausweis、OneID 和 ConnectID 在生产环境中仍处于即将推出状态。 Smart-ID 支持爱沙尼亚、拉脱维亚、立陶宛和比利时；Mobile-ID 支持爱沙尼亚和立陶宛；Finnish Trust Network 支持芬兰。有关国家/地区覆盖范围、配置和验证流程，请参阅 Smart-ID 和 Mobile-ID 集成指南。标记为即将推出的钱包无法在该环境中启用。

选择您的集成方式

当您的应用程序管理界面和认证步骤时，请使用数字身份钱包 API。每个钱包都有一个专用的启动 endpoint，并共用结果、轮询和取消 endpoint。您无需创建工作流。如需使用 Didit 托管的钱包流程、工作流规则以及配置的证件回退，请使用 Sessions API。钱包的可用性、所需的用户批准以及经验证的身份属性适用于这两种集成方式。

前提条件

每个钱包都要求拥有由下文列出的签发方提供的有效身份，并能够使用其认证方法。账户必须符合获取所请求属性的资格，且用户必须同意共享这些属性。签名可核验签发方和返回的声明；它并不保证每个请求的属性都存在、是最新的，或者足以满足您的合规策略。不带人像照片的钱包不包含自拍照比对。目录中的全部 25 个钱包条目均在下方列出，包括两个 BankID 国家/地区、ConnectID、Estonian ID-card 和 eParaksts mobile。配置的证件回退会运行单独的证件检查。不承诺具体上线日期。这些是身份钱包。加密钱包筛查检查区块链地址是否存在金融风险，属于独立产品。

定价

✅ 可用表示已在生产环境中启用。 ⏳ 即将推出表示尚未在生产环境中启用，即使已开始集成测试。可用钱包排在前面。价格列中的按需申请表示该钱包可用，但未发布公开零售费率；这并不意味着免费验证。以下是 Didit 针对下述身份产品制定的标准价格，单位为美元，按每次完成的钱包验证计价。所列价格包含钱包身份核验；不会在此基础上额外加收单独的国家级 eID 交易费用。若已商定特定组织费率，则以约定费率为准。

身份产品	价格（美元）	国家/地区	生产环境可用性
MitID personal	$0.25	丹麦	可用
BankID Sweden	$0.20	瑞典	可用
iDIN full identification	$0.95	荷兰	可用
Finnish Trust Network	$0.25	芬兰	可用
Google Wallet ID	$0.20	美国，英国，巴西，新加坡，台湾	可用
Smart-ID	$0.21	爱沙尼亚，拉脱维亚，立陶宛，比利时	可用
Mobile-ID	$0.21	爱沙尼亚，立陶宛	可用
BankID Norway High	$0.35	挪威	即将推出
Vipps Plus	$0.25	挪威	即将推出
Buypass ID	即将推出	挪威	即将推出
itsme	即将推出	比利时，卢森堡，荷兰	即将推出
Personalausweis Profile 2	$0.49	德国	即将推出
Freja eID	$0.25	瑞典	即将推出
UAE PASS	即将推出	阿联酋	即将推出
gov.br	即将推出	巴西	即将推出
OneID	$2.75	英国	即将推出
GOV.UK Wallet	即将推出	英国	即将推出
Estonian ID-card	$0.55	爱沙尼亚	即将推出
eParaksts mobile	$0.55	拉脱维亚	即将推出
Bank iD	即将推出	捷克	即将推出
MojeID	即将推出	捷克	即将推出
Diia	即将推出	乌克兰	即将推出
FranceConnect	即将推出	法国	即将推出
Auðkenni	即将推出	冰岛	即将推出
ConnectID	即将推出	澳大利亚	即将推出
EUDI Wallet	即将推出	奥地利、比利时、保加利亚、克罗地亚、塞浦路斯、捷克、丹麦、爱沙尼亚、芬兰、法国、德国、希腊、匈牙利、爱尔兰、意大利、拉脱维亚、立陶宛、卢森堡、马耳他、荷兰、波兰、葡萄牙、罗马尼亚、斯洛伐克、斯洛文尼亚、西班牙、瑞典、冰岛、列支敦士登、挪威	即将推出

价格列中的即将推出表示该钱包已在规划中，但其客户价格尚未公布。这并不意味着该验证是免费的。国家/地区旗帜显示钱包的目录覆盖范围；单独的可用性列显示当前是否可以启用它。 公布的价格并不代表启用了钱包。上述可用性来自生产环境目录。标记为即将推出的钱包尚无法在工作流中选择；这些费率将在其可用时生效。

经核验的钱包登录按工作流中的每个身份证件验证节点收费一次，或通过独立钱包 API 按每次验证请求收费一次。重复的回调或状态检查不会产生额外费用。
已取消、已过期、已拒绝或未完成的登录不会产生钱包验证费用。
钱包价格均为标价：您的套餐折扣对其同样适用，就像对其他所有核验一样。
证件回退是一项单独的核验，按证件验证定价计费。工作流中其他已完成的功能将单独计费。

例如，按标准费率计算，1,000 次已完成的 iDIN 完整身份识别验证费用为 $950（不含其他工作流功能）。这是完整身份识别；不是重复登录的价格。上述 BankID 费率适用于挪威 High 级别，而德国 eID 费率适用于 Personalausweis Profile 2。

用户执行的操作

在身份证件步骤中选择其国家/地区，并从您接受的钱包中选择一个钱包。
使用该钱包登录，方式与登录其银行或政府门户网站相同。
同意与您共享其身份属性。
返回并完成验证。

同设备登录会将用户引导至钱包应用，并在完成后将其返回验证流程。跨设备登录会在桌面屏幕上显示二维码，用户使用装有钱包的手机进行扫描。在钱包支持的情况下，两者均会提供；由用户自行选择。当您的工作流启用了 Smart-ID 或 Mobile-ID 时，用户会在验证页面上输入其个人身份代码。 Mobile-ID 还会要求输入与该身份关联的电话号码。页面会显示一个比对码，用户仅在该代码匹配时才在手机上批准。用户在手机上输入其 PIN 码；Didit 绝不会要求用户输入该 PIN 码。此流程可在桌面设备或手机上运行，无需二维码。可用性由生产环境功能目录决定；标记为即将推出的钱包尚无法启用。已启动的登录在有限的时间窗口内保持有效（默认为 10 分钟）。超时后，用户必须重新启动。

钱包采用允许列表

wallet.providers 是某个国家/地区可以提供的钱包列表。这并不是优先级排序：您发送的顺序没有实际意义，保存时会归一化为目录顺序，终端用户可以从您接受的任何钱包中进行选择。启用一个国家/地区的一个钱包或所有钱包均可，由他们自行选择。如果工作流启用了目录未在相应国家/地区提供的钱包，或者仍处于即将推出状态的钱包，API 将拒绝该工作流。

下方每个钱包的属性列表均包含一个签名断言。Didit 会验证该签名并在会话上将判定结果报告为 wallet_verification.signature_valid；断言本身不会传回，因此没有可获取或存储的引用。在会话上一列说明了您对每个属性获得的是两者中的哪一个。

支持的钱包

可用的钱包包括 MitID、BankID Sweden、iDIN、Finnish Trust Network、Smart-ID 和 Mobile-ID。 iDIN 可用于在荷兰进行完整身份识别。 Smart-ID 和 Mobile-ID 支持下表中列出的国家/地区。 Smart-ID 和 Mobile-ID 的国家/地区覆盖范围和所需输入反映了已实现的集成；生产环境的可用性仍单独受控。有关已实现的 Smart-ID 和 Mobile-ID 路由，请参阅集成指南。

钱包	钱包 ID	国家/地区	签发机构	保障等级	可用性
MitID	`mitid`	丹麦	Danish Agency for Digital Government	实质级	可用
BankID	`bankid_se`	瑞典	Finansiell ID-Teknik / 银行财团	实质级	可用
iDIN	`idin`	荷兰	荷兰各银行 (Currence iDIN)	实质级	可用
Finnish Trust Network	`ftn`	芬兰	芬兰各银行及移动运营商 (FTN)	实质级	可用
Google Wallet	`google_wallet`	美国，英国，巴西，新加坡，台湾	Google Wallet（ID pass）及美国各州签发机构（移动驾照）	实质级	可用
Smart-ID	`smart_id`	爱沙尼亚，拉脱维亚，立陶宛，比利时	SK ID Solutions	高级	可用
Mobile-ID	`mobile_id`	爱沙尼亚，立陶宛	SK ID Solutions 及各国移动运营商	高级	可用
BankID	`bankid_no`	挪威	BankID BankAxept AS	高级	即将推出
Vipps	`vipps`	挪威	Vipps MobilePay / BankID NO	实质级	即将推出
Buypass ID	`buypass`	挪威	Buypass AS	高级	即将推出
itsme	`itsme`	比利时，卢森堡，荷兰	Belgian Mobile ID	实质级	即将推出
Personalausweis	`personalausweis`	德国	Bundesministerium des Innern (eID)	高级	即将推出
Freja eID	`frejaid`	瑞典	Freja eID Group	实质级	即将推出
UAE PASS	`uae_pass`	阿联酋	UAE Digital Government Authority	高级	即将推出
gov.br	`govbr`	巴西	Governo Federal do Brasil	实质性	即将推出
OneID	`oneid`	英国	OneID（经英国银行验证的身份）	实质性	即将推出
GOV.UK Wallet	`govuk_wallet`	英国	UK Government Digital Service	高	即将推出
Estonian ID-card	`idcard_ee`	爱沙尼亚	Police and Border Guard Board (Estonia)	未指定	即将推出
eParaksts mobile	`eparaksts_mobile`	拉脱维亚	LVRTC (Latvian State Radio and Television Centre)	未指定	即将推出
Bank iD	`bankid_cz`	捷克	Bankovní identita, a.s.	实质性	即将推出
MojeID	`mojeid`	捷克	CZ.NIC	实质性	即将推出
Diia	`diia`	乌克兰	Ministry of Digital Transformation of Ukraine	高	即将推出
FranceConnect	`franceconnect`	法国	DINUM（法国政府）	实质性	即将推出
Auðkenni	`audkenni`	冰岛	Auðkenni（冰岛电子身份）	高	即将推出
ConnectID	`connectid`	澳大利亚	Australian Payments Plus	未指定	即将推出
EUDI Wallet	`eudi`	奥地利、比利时、保加利亚、克罗地亚、塞浦路斯、捷克、丹麦、爱沙尼亚、芬兰、法国、德国、希腊、匈牙利、爱尔兰、意大利、拉脱维亚、立陶宛、卢森堡、马耳他、荷兰、波兰、葡萄牙、罗马尼亚、斯洛伐克、斯洛文尼亚、西班牙、瑞典、冰岛、列支敦士登、挪威	用户所在的成员国；签发机构因国家/地区而异	高	即将推出

可用性由功能目录提供，而非在此处手动维护。即将推出表示该钱包在控制台中可见但尚无法启用；它不包含承诺的上线日期。

Estonian ID-card 和 eParaksts mobile

两种方式均已集成到钱包目录中，但在生产环境中仍为即将推出。在生产环境目录将其标记为可用之前，无法在生产工作流中启用它们。 API 标识符为爱沙尼亚（EST）的 idcard_ee 以及拉脱维亚（LVA）的 eparaksts_mobile。两者在可用时的定价均为每次完成验证 $0.55；已公布的费率并不意味着已开启生产环境访问权限。

Estonian ID-card： 用户在连接了智能卡读卡器的计算机浏览器中继续操作，并通过卡片软件使用其卡片和 PIN 进行认证。
eParaksts mobile： 用户前往身份登录服务，并使用其处于激活状态的 eParaksts mobile 账户进行批准。桌面端用户可以扫描二维码在手机上继续操作；手机端用户可直接继续。

两者均使用统一的 Didit 钱包选择、交接和返回流程。用户仅在身份服务或卡片软件中输入其认证 PIN，绝不会输入到 Didit 表单中。认证完成后，Didit 会验证已签名的身份属性并继续执行已配置的工作流。取消或失败将遵循工作流配置的证件回退或拒绝操作。

白标适用于 Didit 验证界面。 这两种方式的外部认证界面仍保留其自身的服务品牌标识。自定义徽标、服务名称和白标样式不会应用到这些外部界面。

通过 API 使用这些钱包

两种方式还支持无需 workflow_id 的独立 API 验证。独立 API 和工作流在生产环境的可用性一致；在向用户提供任一方式之前，请先检查 GET /v3/id-verification/wallets/。

钱包	发起 endpoint
🇪🇪 Estonian ID-card	`POST /v3/id-verification/wallets/idcard-ee/`
🇱🇻 eParaksts mobile	`POST /v3/id-verification/wallets/eparaksts-mobile/`

请在后端妥善保管您的 x-api-key，并在应用的 allowed_return_hosts 设置中注册其返回主机。在发起验证时，发送该主机下的 HTTPS return_url。发起响应会返回一个 request_id 以及供用户浏览器使用的 wallet_verification.next_action.url。将用户重定向至该 URL，以便他们使用卡片或应用进行认证。用户返回后，从您的后端调用 GET /v3/id-verification/wallets/verifications/{request_id}/ 以核验验证结果，或者处理已签名的 status.updated Webhook。请勿仅将浏览器重定向视为验证成功的证明。相同的价格和完成验证计费规则适用于这两种集成方式。

Google Wallet

Google Wallet 允许用户通过 W3C Digital Credentials API，将其手机中的政府签发证件共享至您的页面或应用。它在生产环境和沙盒中均可用。沙盒应用无需注册。每个生产环境应用在使用 Google Wallet 之前需注册一次：在控制台中，打开身份证件验证步骤，找到受支持国家对应的 Google Wallet 行，选择向 Google 注册并完成一次性设置，耗时约一分钟。之后，当用户共享证件时，Google 会显示您的名称和徽标。在应用完成注册之前，保存启用了 Google Wallet 的工作流将被拒绝，并提示 “Register this application with Google before enabling Google Wallet”。您客户的终端用户看到的选项为 Verify with digital ID，因为除了 Google Wallet 之外，任何支持相同 OpenID4VP 请求且持有兼容证件（身份证件通行证或移动驾照）的其他 Android 钱包也都能响应此请求。

国家/地区： 美国、英国、巴西、新加坡和台湾。
凭证： 根据护照创建的 Google Wallet 身份证件通行证，以及受支持美国各州的移动驾照。
返回内容： 姓名、出生日期、证件号码、证件到期日期、签发国家/地区与发证机构，以及身份证件通行证的国籍。结果中还包含该凭证的 signature_valid 判定结论。不共享人像照片。
隐私： Didit 仅请求其所需的字段，且仅有这些字段会离开钱包。用户在自己设备上的 Google Wallet 中批准共享。

该过程无需重定向：用户在浏览器或 Android 原生钱包提示中进行确认，当钱包位于手机上时，桌面端浏览器会显示专属二维码。验证请求由您的页面或应用发起，因此API 集成需要您页面的 HTTPS 源（origin）。来自 Sessions API 的托管流程仅在支持的浏览器和设备上提供该方式，否则保留证件回退。当您在自己的页面内展示托管流程时，请使用 Web SDK 0.5.1 或更高版本，或向 iframe 的 allow 属性添加 digital-credentials-get：若未添加，浏览器将在 iframe 内拒绝钱包请求。

其他即将推出的钱包

ConnectID（澳大利亚）已集成用于沙盒测试，并在钱包目录中显示为 connectid。用户使用 ConnectID 选择器选择一家参与测试的银行，使用该银行账户登录并查看共享请求。初始身份信息包请求名、姓和出生日期，并附带用于验证的交易参考。它不会请求地址、电话号码、邮箱地址、账户余额或交易历史记录。共享通知会指明 Didit 以及接收已验证身份的企业。银行凭据保留在银行端。生产环境访问权限仍为即将推出；沙盒测试不会启用生产环境身份验证。激活前必须完成经批准的生产环境用例、客户入驻、所需条款以及认证。表格中其他标记为即将推出的钱包在生产环境中同样不可用。不承诺具体上线日期。

保证级别

当钱包提供 eIDAS 保证级别（low、substantial 或 high）时，Didit 会记录结果中实际声明的级别。未指定 eIDAS 级别的钱包（例如 ConnectID）显示为未指定；其集成并不意味着具有 eIDAS 保证声明。如果钱包返回的级别低于所请求的级别，登录将直接失败，而不是悄悄降级。当您的合规规则依赖于该级别时，请检查会话中的 wallet_verification.level_of_assurance。

各钱包参考

MitID

mitid · 可用


国家/地区	丹麦
签发机构	丹麦数字政府局（Danish Agency for Digital Government）
覆盖范围	覆盖约 95% 的成年人
安全保障等级	相当（Substantial）
提供人脸照片	否
前提条件	拥有有效的 MitID 身份及其登录方式的使用权限
价格（美元）	每次完成验证 $0.25（MitID 个人版）

录入 Didit 的信息： 姓名 · 出生日期 · CPR 别名（假名化）

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；各钱包的属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；各钱包的属性名称可能有所不同
CPR 别名（假名化）	`cpr_alias`	在 `wallet_verification.attributes` 中返回
达到的安全保障等级	`level_of_assurance`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部完成验证；会话返回 `signature_valid` 判定结论，而非断言本身

BankID

bankid_se · 可用


国家/地区	瑞典
签发机构	Finansiell ID-Teknik / 银行财团
覆盖范围	覆盖约 99% 的成年人
安全保障等级	相当（Substantial）
提供人脸照片	否
前提条件	拥有有效的 BankID 身份及其登录方式的使用权限
价格（美元）	每次完成验证 $0.20（BankID 瑞典）

录入 Didit 的信息： 姓名 · 个人身份识别号

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；各钱包的属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；各钱包的属性名称可能有所不同
个人身份识别号	`personal_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部完成验证；会话返回 `signature_valid` 判定结论，而非断言本身

iDIN

idin · 可用


国家/地区	荷兰
签发机构	荷兰各银行（Currence iDIN）
覆盖范围	所有荷兰银行客户
安全保障等级	相当（Substantial）
提供人脸照片	否
前提条件	拥有合作荷兰银行的 iDIN 认证权限
价格（美元）	每次完成验证 $0.95（iDIN 完整身份识别）

录入 Didit 的信息： 姓名 · 出生日期 · 地址

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；各钱包的属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；各钱包的属性名称可能有所不同
性别	`gender`	在 `wallet_verification.attributes` 中返回
地址	`address`	在 `wallet_verification.attributes` 中返回
银行标识符	`bank_identifier`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部完成验证；会话返回 `signature_valid` 判定结论，而非断言本身

Finnish Trust Network

ftn · 可用


国家/地区	芬兰
签发机构	芬兰各银行与移动运营商（FTN）
覆盖范围	所有芬兰银行客户
安全保障等级	相当（Substantial）
提供人脸照片	否
前提条件	拥有有效的 Finnish Trust Network 身份及其登录方式的使用权限
价格（美元）	每次完成验证 $0.25（Finnish Trust Network）

录入 Didit 的信息： 姓名 · 个人身份代码

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；各钱包的属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；各钱包的属性名称可能有所不同
个人身份代码	`personal_identity_code`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部完成验证；会话返回 `signature_valid` 判定结论，而非断言本身

Google Wallet

google_wallet · 可用


国家/地区	美国，英国，巴西，新加坡，台湾
签发机构	Google Wallet（ID 通行证）及美国各州签发机构（移动驾照）
覆盖范围	基于护照的 ID 通行证，以及支持的美国各州的移动驾照，由 Google Wallet 或任何其他持有兼容数字身份的 Android 钱包返回；终端用户看到的选项为使用数字身份验证
保障等级	实质性
共享人像照片	否
前提条件	有效的 Google Wallet 身份及对其登录方式的访问权限
价格 (USD)	每次完成验证 $0.20（Google Wallet ID）

在 Didit 中输入的信息：未在 Didit 中输入任何身份详情

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中规范化为 `full_name`；各钱包属性名称有所不同
出生日期	`date_of_birth`	在身份证件验证结果中规范化为 `date_of_birth`；各钱包属性名称有所不同
证件号码	`document_number`	在 `wallet_verification.attributes` 中返回
证件到期日期	`document_expiry_date`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定结果，而非断言本身

Smart-ID

smart_id · 可用


国家/地区	爱沙尼亚，拉脱维亚，立陶宛，比利时
签发机构	SK ID Solutions
覆盖范围	覆盖波罗的海三国的大多数成年人
保障等级	高
共享人像照片	否
前提条件	有效的 Smart-ID 身份及对其登录方式的访问权限
价格 (USD)	每次完成验证 $0.21（Smart-ID）

在 Didit 中输入的信息：个人身份代码

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中规范化为 `full_name`；各钱包属性名称有所不同
出生日期	`date_of_birth`	在身份证件验证结果中规范化为 `date_of_birth`；各钱包属性名称有所不同
个人身份代码	`personal_code`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定结果，而非断言本身

Mobile-ID

mobile_id · 可用


国家/地区	爱沙尼亚，立陶宛
签发机构	SK ID Solutions 与各国移动运营商
覆盖范围	基于 SIM 卡的国家电子身份 (eID)
保障等级	高
共享人像照片	否
前提条件	有效的 Mobile-ID 身份及对其登录方式的访问权限
价格 (USD)	每次完成验证 $0.21（Mobile-ID）

在 Didit 中输入的信息：个人身份代码 · Mobile-ID 电话号码

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中规范化为 `full_name`；各钱包属性名称有所不同
出生日期	`date_of_birth`	在身份证件验证结果中规范化为 `date_of_birth`；各钱包属性名称有所不同
个人身份代码	`personal_code`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定结果，而非断言本身

BankID

bankid_no · 即将推出


国家/地区	挪威
签发机构	BankID BankAxept AS
覆盖范围	国家电子身份 (eID)
保障等级	高
共享人像照片	否
前提条件	有效的 BankID 身份及对其登录方式的访问权限
价格 (USD)	每次完成验证 $0.35（BankID Norway High）

在 Didit 中输入的信息：姓名 · 出生日期 · 国民身份号码

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中规范化为 `full_name`；各钱包属性名称有所不同
出生日期	`date_of_birth`	在身份证件验证结果中规范化为 `date_of_birth`；各钱包属性名称有所不同
国民身份号码	`national_identity_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定结果，而非断言本身

Vipps

vipps · 即将推出


国家/地区	挪威
签发机构	Vipps MobilePay / BankID NO
覆盖范围	覆盖约 90% 的成年人
保障等级	实质性
共享人像照片	否
前提条件	有效的 Vipps 身份及对其登录方式的访问权限
价格 (USD)	每次完成验证收费 $0.25（Vipps Plus）

录入 Didit 的信息：姓名 · 出生日期 · 国民身份号码

返回的属性	键	会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
国民身份号码	`national_identity_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

Buypass ID

buypass · 即将推出


国家/地区	挪威
签发机构	Buypass AS
覆盖范围	覆盖约 35% 的成年人
保证级别	高
共享肖像	否
前提条件	有效的 Buypass ID 身份并可使用其登录方式

录入 Didit 的信息：姓名 · 出生日期 · 国民身份号码

返回的属性	键	会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

itsme

itsme · 即将推出


国家/地区	比利时，卢森堡，荷兰
签发机构	Belgian Mobile ID
覆盖范围	覆盖约 78% 的成年人
保证级别	实质性
共享肖像	否
前提条件	有效的 itsme 身份并可使用其登录方式

录入 Didit 的信息：姓名 · 出生日期 · 国家登记号码

返回的属性	键	会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
国家登记号码	`national_register_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

Personalausweis

personalausweis · 即将推出


国家/地区	德国
签发机构	Bundesministerium des Innern (eID)
覆盖范围	所有开通在线功能的德国身份证
保证级别	高
共享肖像	否
前提条件	有效的 Personalausweis 身份并可使用其登录方式
价格 (USD)	每次完成验证收费 $0.49（Personalausweis Profile 2）

录入 Didit 的信息：姓名 · 出生日期 · 国籍 · 地址

返回的属性	键	会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
国籍	`nationality`	在 `wallet_verification.attributes` 中返回
地址	`address`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

Freja eID

frejaid · 即将推出


国家/地区	瑞典
签发机构	Freja eID Group
覆盖范围	经政府批准的瑞典电子身份证
保证级别	实质性
共享肖像	否
前提条件	拥有 Freja Plus 身份并可使用 Freja 应用程序；不支持 Basic 和 Extended
价格 (USD)	每次完成验证收费 $0.25（Freja eID）

录入 Didit 的信息：姓名 · 出生日期 · 个人身份编号

返回的属性	键	会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
个人身份编号	`personal_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

UAE PASS

uae_pass · 即将推出


国家/地区	阿拉伯联合酋长国
签发机构	UAE Digital Government Authority
覆盖范围	政府登录
可信度等级	高
共享人像照片	是
前提条件	有效的 UAE PASS 身份并可访问其登录方式

录入 Didit 的信息： 姓名 · 阿联酋身份证号 · 国籍 · 人像照片

返回的属性	键	在会话中
姓名（英文与阿拉伯文）	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
阿联酋身份证号	`emirates_id_number`	在 `wallet_verification.attributes` 中返回
国籍	`nationality`	在 `wallet_verification.attributes` 中返回
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
人像照片	`portrait`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

gov.br

govbr · 即将推出


国家/地区	巴西
签发机构	Governo Federal do Brasil
覆盖范围	政府登录
可信度等级	实质性
共享人像照片	否
前提条件	有效的 gov.br 身份并可访问其登录方式

录入 Didit 的信息： 姓名 · CPF

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
CPF	`tax_number`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

OneID

oneid · 即将推出


国家/地区	英国
签发机构	OneID（英国银行验证身份）
覆盖范围	英国活期账户持有人的银行验证身份
可信度等级	实质性
共享人像照片	否
前提条件	有效的 OneID 身份并可访问其登录方式
价格 (USD)	每次完成验证 $2.75（OneID）

录入 Didit 的信息： 姓名 · 出生日期

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
地址	`address`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

GOV.UK Wallet

govuk_wallet · 即将推出


国家/地区	英国
签发机构	UK Government Digital Service
覆盖范围	政府钱包；驾照凭证逐步推出中
可信度等级	高
共享人像照片	是
前提条件	有效的 GOV.UK Wallet 身份并可访问其登录方式

录入 Didit 的信息： 姓名 · 出生日期 · 人像照片

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
人像照片	`portrait`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

Estonian ID-card

idcard_ee · 即将推出


国家/地区	爱沙尼亚
签发机构	Police and Border Guard Board (Estonia)
覆盖范围	配合智能卡读卡器使用的爱沙尼亚 ID 卡
可信度等级	未指定
共享人像照片	否
前提条件	有效的爱沙尼亚 ID 卡身份并可访问其登录方式
价格 (USD)	每次完成验证 $0.55（爱沙尼亚 ID 卡）

录入 Didit 的信息： 姓名 · 出生日期 · 个人识别码

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
个人识别码	`personal_code`	在 `wallet_verification.attributes` 中返回
签发个人识别码的国家/地区	`personal_code_country`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定结果，而非断言本身

eParaksts mobile

eparaksts_mobile · 即将推出


国家/地区	拉脱维亚
签发机构	LVRTC（拉脱维亚国家广播电视中心）
覆盖范围	通过拉脱维亚的 eParaksts mobile 应用进行身份认证
保障等级	未指定
共享人像照	否
前提条件	拥有活跃的 eParaksts mobile 身份并可使用其登录方式
价格 (USD)	每次完成验证 $0.55（eParaksts mobile）

在 Didit 中录入的信息： 姓名 · 出生日期 · 个人身份识别码

返回的属性	键	会话中体现
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
个人身份识别码	`personal_code`	在 `wallet_verification.attributes` 中返回
签发个人身份识别码的国家/地区	`personal_code_country`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定，而非断言本身

Bank iD

bankid_cz · 即将推出


国家/地区	捷克
签发机构	Bankovní identita, a.s.
覆盖范围	联合式银行身份；捷克使用最广泛的登录方式
保障等级	实质性
共享人像照	否
前提条件	拥有活跃的 Bank iD 身份并可使用其登录方式

在 Didit 中录入的信息： 姓名 · 出生日期

返回的属性	键	会话中体现
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
地址	`address`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定，而非断言本身

MojeID

mojeid · 即将推出


国家/地区	捷克
签发机构	CZ.NIC
覆盖范围	约 50 万个活跃账户；其中一部分达到实质性保障等级
保障等级	实质性
共享人像照	否
前提条件	拥有活跃的 MojeID 身份并可使用其登录方式

在 Didit 中录入的信息： 姓名 · 出生日期

返回的属性	键	会话中体现
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定，而非断言本身

Diia

diia · 即将推出


国家/地区	乌克兰
签发机构	乌克兰数字化转型部
覆盖范围	包含国民身份证、护照和驾照的政府应用
保障等级	高
共享人像照	是
前提条件	拥有活跃的 Diia 身份并可使用其登录方式

在 Didit 中录入的信息： 姓名 · 出生日期 · 人像照

返回的属性	键	会话中体现
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
证件号码	`document_number`	在 `wallet_verification.attributes` 中返回
人像照	`portrait`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定，而非断言本身

FranceConnect

franceconnect · 即将推出


国家/地区	法国
签发机构	DINUM（法国政府机构）
覆盖范围	联合式国家身份；FranceConnect+ 提供实质性保障等级
保障等级	实质性
共享人像照	否
前提条件	拥有活跃的 FranceConnect 身份并可使用其登录方式

在 Didit 中录入的信息： 姓名 · 出生日期

返回的属性	键	会话中体现
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
出生地	`birthplace`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部进行验证；会话返回 `signature_valid` 判定，而非断言本身

Auðkenni

audkenni · 即将推出


国家/地区	冰岛
签发机构	Auðkenni（冰岛电子身份）
覆盖范围	基于 SIM 卡和应用的国家电子身份
保证级别	高
共享人像照片	否
前提条件	有效的 Auðkenni 身份以及对其登录方式的访问权限

在 Didit 中输入的信息： 姓名 · Kennitala

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
Kennitala	`national_id`	在 `wallet_verification.attributes` 中返回
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定，而非断言本身

ConnectID

connectid · 即将推出


国家/地区	澳大利亚
签发机构	Australian Payments Plus
覆盖范围	直接沙盒集成；生产环境即将推出
保证级别	未指明
共享人像照片	否
前提条件	有效的 ConnectID 身份以及对其登录方式的访问权限

在 Didit 中输入的信息： 未在 Didit 中输入身份信息

返回的属性	键	在会话中
姓名	`full_name`	在身份证件验证结果中归一化为 `full_name`；钱包属性名称可能有所不同
出生日期	`date_of_birth`	在身份证件验证结果中归一化为 `date_of_birth`；钱包属性名称可能有所不同
签名断言	`signed_assertion`	在 Didit 内部验证；会话返回 `signature_valid` 判定，而非断言本身

EUDI Wallet

eudi · 即将推出


国家/地区	奥地利, 比利时, 保加利亚, 克罗地亚, 塞浦路斯, 捷克, 丹麦, 爱沙尼亚, 芬兰, 法国, 德国, 希腊, 匈牙利, 爱尔兰, 意大利, 拉脱维亚, 立陶宛, 卢森堡, 马耳他, 荷兰, 波兰, 葡萄牙, 罗马尼亚, 斯洛伐克, 斯洛文尼亚, 西班牙, 瑞典, 冰岛, 列支敦士登, 挪威
签发机构	用户所在的成员国；签发方因国家/地区而异
覆盖范围	即将推出 - 欧盟范围推广
保证等级	高
共享肖像照	是
前置条件	有效的 EUDI Wallet 身份并可使用其登录方式

在 Didit 中输入的信息： PID - 个人身份数据

返回的属性	键	会话中
架构遵循 ARF PID 规则手册	`pid`	在 `wallet_verification.attributes` 中返回

失败与后备方案

结果	含义	计费
`verified`	用户已登录且签名属性核验通过。	是
`cancelled`	用户退出了钱包登录。	否
`timeout`	登录窗口在完成前已过期。	否
`failed`	无法完成登录或断言未核验通过。	否

除 verified 之外的任何结果均遵循相应国家/地区的 wallet.on_failure 开关：fallback_to_document 会引导用户进行证件采集，decline 则以已拒绝的身份证件验证结束会话。如果在该国家/地区禁用了证件采集，设置 fallback_to_document 仍会拒绝，因为没有可供回退的途径。要仅在钱包登录失败后才显示证件采集，请参阅仅将证件采集作为后备方案。只有完成的登录才会计费。已放弃、已取消、已超时和失败的登录均不收取任何费用。

会话返回的数据

{
  "node_id": "feature_ocr_1",
  "status": "Approved",
  "verification_method": "wallet",
  "assurance": "cryptographic",
  "wallet_provider": "mitid",
  "fallback_from": null,
  "id_lookup": null,
  "wallet_verification": {
    "provider": "mitid",
    "provider_name": "MitID",
    "issuing_authority": "Danish Agency for Digital Government",
    "issuing_country": "DNK",
    "credential_type": "person_identification",
    "level_of_assurance": "substantial",
    "verified_at": "2026-09-04T09:12:44Z",
    "signature_valid": true,
    "attributes": {
      "full_name": "Freja Nielsen",
      "date_of_birth": "1988-03-02",
      "cpr_alias": "b0f1c2d3-e4f5-4678-9abc-def012345678"
    },
    "portrait": null,
    "face_match_score": null
  }
}

attributes 包含经过验证的钱包声明，其名称因钱包而异。标准化身份字段请使用身份证件验证结果中的 full_name 和 date_of_birth。各个钱包的说明表格区分了这些标准化字段与钱包特有的属性。portrait 仅存在于共享肖像照的钱包中。signature_valid 是对钱包返回的已签名断言进行验证的结果。在完成的登录中它为 true：未通过验证的断言会导致登录失败并遵循 wallet.on_failure，而不会产生已通过的结果。完整字段类型请参阅身份证件验证数据模型。

配置钱包

此配置片段仅当您的环境目录中在所选国家/地区将每个选定钱包标记为 available 时才可使用。提交不可用的钱包会导致整个工作流保存操作被拒绝，包括同一请求中的任何其他方式。有关 Smart-ID 和 Mobile-ID 的示例，请参阅集成指南。

{
  "DNK": {
    "document": { "enabled": true },
    "wallet": { "enabled": true, "providers": ["mitid"], "on_failure": "fallback_to_document" }
  },
  "NOR": {
    "document": { "enabled": true },
    "wallet": { "enabled": true, "providers": ["bankid_no", "vipps"], "on_failure": "decline" }
  }
}

当 wallet.enabled 为 true 时，请至少启用一个钱包，否则保存将被拒绝。完整参考请参阅工作流功能配置。

​选择您的集成方式

​前提条件

​定价

​用户执行的操作

​钱包采用允许列表

​支持的钱包

​Estonian ID-card 和 eParaksts mobile

​通过 API 使用这些钱包

​Google Wallet

​其他即将推出的钱包

​保证级别

​各钱包参考

​MitID

​BankID

​iDIN

​Finnish Trust Network

​Google Wallet

​Smart-ID

​Mobile-ID

​BankID

​Vipps

​Buypass ID

​itsme

​Personalausweis

​Freja eID

​UAE PASS

​gov.br

​OneID

​GOV.UK Wallet

​Estonian ID-card

​eParaksts mobile

​Bank iD

​MojeID

​Diia

​FranceConnect

​Auðkenni

​ConnectID

​EUDI Wallet

​失败与后备方案

​会话返回的数据

​配置钱包

​相关内容

选择您的集成方式

前提条件

定价

用户执行的操作

钱包采用允许列表

支持的钱包

Estonian ID-card 和 eParaksts mobile

通过 API 使用这些钱包

Google Wallet

其他即将推出的钱包

保证级别

各钱包参考

MitID

BankID

iDIN

Finnish Trust Network

Google Wallet

Smart-ID

Mobile-ID

BankID

Vipps

Buypass ID

itsme

Personalausweis

Freja eID

UAE PASS

gov.br

OneID

GOV.UK Wallet

Estonian ID-card

eParaksts mobile

Bank iD

MojeID

Diia

FranceConnect

Auðkenni

ConnectID

EUDI Wallet

失败与后备方案

会话返回的数据

配置钱包

相关内容