瑞典 BankID API：直接作为依赖方还是通过中介商接入，完整指南
企业如何在瑞典接入 BankID API：通过银行直接接入或经由中介商接入，一次登录返回哪些数据，其在反洗钱和博彩领域的法律效力，相关限制以及证件核验备用方案。
要点
企业可以通过 BankID API，借助 BankID 应用识别瑞典用户的身份，或收集用户签名。2025 年有 8.7百万人使用 BankID。[1]接入该 API 有两种方式：一是向银行购买服务，作为直接依赖方自行集成；二是通过已完成集成的经销商接入。[4]
- 一次登录返回经签名的 12 位 personnummer 和姓名。不返回地址，也不返回照片。[6]
- BankID 属于瑞典 eID 方案（按实质级和高级通报），DIGG 将 BankID 列为实质级。价格未公开。[4][10][11]
BankID 是瑞典的电子身份识别（eID）：由各银行按照统一规则签发的私营应用[3]，并获得国家数字化机构 DIGG 的批准。[11]对企业而言，这是确认瑞典客户身份的默认方式，得到的是经签名的结果，而不是证件照片。
BankID Sweden 概览
BankID Sweden
瑞典由银行签发的电子身份识别
BankID 的使用人数
来源：BankID 数据一览，2025 年数据。[1]
使用量从 2019 年的 4.1十亿笔交易增长到 2025 年的 7.9十亿笔。[1]
| 行业 | BankID 使用占比，2025 |
|---|---|
| 银行和金融 | 50% |
| 其他私营服务 | 27% |
| 移动支付 | 17% |
| 公共部门 | 6% |
BankID 数据一览。[1]
- 2002年9月成立Finansiell ID-Teknik BID 成立。
- 2011年6月移动应用Mobile BankID 上线。
- 2020年12月14日完成通报包含 BankID 的瑞典电子身份方案根据 eIDAS 完成通报。
- 2026年8月17日人脸核验人脸识别加强验证开始可用。
- 2026年12月1日SverigeID国家电子身份与 BankID 并行开放。
从公司成立到国家电子身份。[2][10][7][17]
用户看到的内容
在手机上，BankID 应用会在同一设备上打开。在电脑上，用户用该应用扫描二维码。[6]根据对 BankID 流程的研究，用户随后通过安全码或生物识别进行确认；BankID 的 collect 参考文档通过其错误代码印证了安全码这一步骤。[6]
选择验证方式
使用您已在用的电子身份登录。
BankID
改用身份证件
1用户在您的注册流程中选择 BankID。
在电脑上：使用 BankID 扫码
在手机上打开 BankID 应用并扫描此二维码。
2仅限电脑：二维码将请求转交到手机。在手机上会跳过此页面。[6]
验证身份
先确认请求方，再输入您的安全码。
3用户在应用中确认（根据对 BankID 流程的研究，通过安全码或生物识别）。[6]
额外核验
轻触您的护照或身份证，或拍摄一张自拍。
4服务方可要求的可选加强验证。[7]
您已通过验证
- 姓名已共享
- Personnummer已共享
- 地址未共享
- 肖像照片未共享
5带着已签名的结果返回您的服务。[6]
第4屏为可选步骤：通过NFC读取护照或身份证，或自2026年8月17日起，将面部与瑞典护照或身份证芯片中的照片进行人脸识别比对。[6][7]驾驶证没有芯片，因此不能用于这一增强验证。[7]
视频待上线：flow-qr-cross-device
使用二维码进行跨设备登录的完整流程。
BankID API向企业返回哪些内容
您的后端通过/auth（身份识别）或/sign发起订单，然后在订单处于待处理状态时每两秒调用一次/collect。[6]用户确认后，响应中会包含completionData。
用户在BankID应用中确认
直接集成BankID的简化流程。提示代码告诉您应向用户显示什么内容。[6]
| 字段 | 返回时机 | 含义 |
|---|---|---|
| personalNumber | 始终返回 | 瑞典国民身份号码，12位数字 |
| name, givenName, surname | 始终返回 | 全名及其组成部分 |
| signature | 始终 | Base 64 编码的 XML 签名 |
| ocspResponse | 始终 | 该签名的已签名证书状态 |
| device.ipAddress, device.uhi | 返回 | BankID 获取的 IP，唯一硬件标识符 |
| bankIdIssueDate | 返回 | BankID 的签发日期 |
| stepUp.mrtd, stepUp.face | 如执行了加强验证 | 是否完成了芯片或人脸核验 |
| risk | 仅在请求时 | low、moderate 或 high |
| 地址、国籍、肖像 | 从不 | 不在响应中 |
已完成订单的 collect 响应。[6]
出生日期编码在 personnummer 中，因此每次登录都附带年龄核验。[3]
保证级别与法律地位
瑞典于2020年12月14日根据 eIDAS 通报了一个总括方案“Swedish eID”，将 BankID、Freja eID 和 EFOS 列为其手段，级别为实质级（Substantial）和高级（High）。[10] DIGG 自己的瑞典已通报电子身份列表将 Mobile BankID、BankID on file 和 BankID on card 列为实质级（Substantial）。[11] 在瑞典信任框架下，它处于信任等级 3。[3][11]
| 法律文件 | 对 BankID 的意义 |
|---|---|
| DIGG 瑞典电子身份信任框架 | BankID 获批为信任等级 3，与 DIGG 在该等级列出的其他电子身份并列[11] |
| eIDAS，条例 (EU) No 910/2014 | 已作为瑞典 eID 方案的一部分完成通报；BankID 表示，BankID 签名属于高级电子签名[3][10] |
| PSD2 | 身份识别满足强客户认证要求；签名满足动态关联要求[3] |
| Lag (2017:630)，第3章第7条 | eIDAS 电子身份识别手段可用于反洗钱检查中的身份核验[13] |
| Spellagen (2018:1138)，第12章第2条 | 博彩持牌机构必须通过可靠的电子身份识别核验身份[14] |
| 《刑法典》第15章第12条 | 使用他人的 BankID 构成滥用文书[3] |
| Lag (2026:1358) | 国家电子身份法，自2026年12月1日起适用[12] |
关于客户尽职调查，瑞典反洗钱法规定：
第3章第7条Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism
"När första stycket tillämpas får man använda medel för elektronisk identifiering och betrodda tjänster enligt ... (EU) nr 910/2014"
中文含义：eIDAS 电子身份识别手段可用于核验身份。尽职调查整体上仍以风险为本。
自2027年7月10日起，欧盟《反洗钱条例》（AMLR）开始适用。其第22(6)(b)条接受“实质级”或“高级”保证级别的电子身份识别手段，因此 BankID 达到这一标准。[15] 欧盟反洗钱局（AMLA）的最终标准草案已于2026年9月30日提交欧盟委员会，尚未成为法律。根据该草案，电子身份识别手段“应尽可能使用”，远程证件核验是为无法使用此类手段的客户提供的后备方案。草案将欧盟数字身份钱包（EUDI Wallet）列为此类手段之一。[16]
注意
SverigeID 是由瑞典警察局签发的国家电子身份，将于2026年12月1日开放。DIGG 已按瑞典信任级别4（最高级别）批准该身份。截至2026年10月5日，它尚未列入欧盟已通报方案清单。它是对 BankID 和 Freja eID 的补充，而非替代。[11][17]
如何对接 BankID Sweden API：直接对接或通过中介机构对接
BankID 的回答是：“您可以从银行或通过零售商购买 BankID 服务。”[4]
直接依赖方
向银行购买，自行开发
- 与销售 BankID 的银行签订合同
- 通过 BankID Keygen 申请依赖方（FP）证书
- 自行开发 start、QR 码、collect、用户提示消息和取消处理
- 每次身份识别和签名的价格，与银行协商确定
最适合拥有内部团队、服务单一国家的业务
通过中介或经销商
一份合同，一次集成
- 与转售商签订合同，由转售商采购 BankID 服务
- 您调用转售商的 API，而不是 BankID 的 API
- 与 BankID 对接的是转售商的集成，而不是您的集成
- 按次核验计价，价格由转售商设定
最适合多国客户准入
两种途径都适用同一套 BankID 规则。[4]
两种途径的价格均未公开。费用“通常根据完成的身份识别和签名数量计算”，私营部门的价格由市场竞争决定。[4]截至2026年10月5日，接入所需时间也未公开。
有些规则在两种途径下都对您有约束力。BankID 的合同规则禁止“身份切换”(ID switching)，即利用一次登录签发密码或其他凭证，或在用户不活动超过两小时后仍通过 cookie 保持其登录状态。[4]新的提示码(hint code)可能会“不经事先通知”出现，直接集成必须能够处理未知的提示码。[6]
公共机构通过 DIGG 的授权系统支付固定价格；私营公司只能接入 DIGG 的 eIDAS 节点。[4][12]商务方面的内容见瑞典企业版 BankID。
BankID API 使用场景
| 使用场景 | BankID 为您提供什么 | 依据规则 |
|---|---|---|
| KYC 和反洗钱客户准入 | 来自已通报电子身份(eID)的已验证身份 | Lag (2017:630) 第3章第7条[13] |
| 在线博彩 | 注册时可靠的电子身份识别 | Spellagen 第12章第2条[14] |
| 年龄核验 | 从 personnummer 中获取出生日期 | Collect 响应[6] |
| 支付 | 强客户认证和动态关联 | PSD2[3] |
| 合同和信贷 | 高级电子签名 | eIDAS，(EU) No 910/2014 号条例[3] |
博彩行业另有两条规则：在线注册仅限瑞典居民，且牌照不得覆盖18岁以下人士。[14]
限制与备用方案
办理 BankID 需要瑞典 personnummer 和一家发行银行。[5]
- 未成年人：年龄下限由银行设定，“最常见的是……13岁或18岁”，未成年人需获得父母同意。[5]
- 旅居海外的瑞典人如被从 SPAR 登记册中移除，可能丧失申领资格。[5]
- 外国公民：BankID 的新闻列表公布，自2026年5月5日起，已登记的非瑞典公民可使用欧盟护照续期；没有 personnummer 的访客和非居民无法申领。[5][9]
据 Computer Sweden 报道，警方称引入二维码后，围绕 BankID 登录的电话诈骗下降了90%。2026年，BankID 新增了支付警告和人脸加强验证步骤。[9]
对于其他所有用户，备选方案是证件核验：通过 NFC 读取护照或身份证芯片（参见 NFC eID 核验与芯片安全），进行活体检测并比对人脸。
1优先向瑞典用户提供 BankID
同一设备上的应用，或电脑上的二维码。
用户完成一笔 BankID 订单
接受已签名的结果
Personnummer、姓名、签名、OCSP。
通过证件核验
NFC 芯片读取、活体检测和人脸比对。
2从其他来源补充地址
BankID 不返回地址。
3筛查并决定
制裁和 PEP 筛查；决定权仍在您手中。
先用 eID，证件作为备选，最后统一做出一项决定。
BankID 集成检查清单
- 在与银行直接签约和通过经销商之间做出选择。
- 列出您的政策所需的属性以及地址来源。
- 支持同设备启动，并在桌面端支持二维码。
- 每两秒轮询一次 collect，状态为 failed 时停止。[6]
- 为每个提示码映射一条用户提示信息，包括未知的提示码。[6]
- 确定是否使用风险指标以及加强验证步骤。
- 保存签名和 OCSP 响应，以备审计。[6]
- 按照两小时规则结束闲置会话。[4]
- 为没有 BankID 的用户构建证件核验备选方案。
- 正式上线前，请先在 BankID 的测试环境中完成测试。
Didit 如何协助 BankID Sweden 验证
BankID Sweden 已在 Didit 上线。用户在托管流程或 SDK 中选择 BankID，然后在同一部手机上或通过二维码登录。Didit 从不索要 BankID 安全码（PIN）。
可在控制台的 Workflows、ID Verification、Countries、Wallets accepted 下开启，也可通过 workflows API 开启。一次登录会返回全名、出生日期、瑞典 personnummer、保证级别（标注为实质级）以及签名校验结果（返回的是校验结论，而非原始签名）。不返回地址，也不返回人像照片。没有 BankID 的用户在同一工作流中改走证件采集路径，配合 NFC 芯片读取、活体检测和人脸比对。一次完整的 KYC 核验费用为 $0.33，NFC 验证为 $0.15，AML 筛查为 $0.20。
只有完成的 BankID 登录才会计费；已取消、超时和失败的登录不收费。证件核验按次计价。BankID 的费用为 $0.20（价格）；已上线的电子身份见数字身份钱包页面。
截图待补：hosted-flow-wallet-chooser
用户在 Didit 流程中选择 BankID。
截图待补：hosted-flow-qr
在电脑上，通过二维码将登录转到手机上完成。
截图待补：console-wallets-accepted
在 Didit 控制台中开启 BankID Sweden。
Didit 提供
- 托管流程或 SDK 中的 BankID Sweden 登录
- 为没有 BankID 的用户提供证件核验路径
- 经签名的属性以及每项核验的证据
由您负责
- 风险评估和相关政策
- 客户准入决策
- 客户地址的信息来源
要点
- 2025年有8.7百万人使用BankID，在18至67岁的已登记瑞典人中，99.9%已开通。
- 您可以向银行购买 BankID 并自行集成，也可以通过转售商接入；价格不公开。
- 一次登录会返回经签名的 personnummer 和姓名，但不返回地址，也不返回人像照片。
- DIGG 将 BankID 列为实质级（Substantial），自2027年7月10日起满足 AMLR 第 22(6)(b) 条的要求。
常见问题
BankID API 的费用是多少？
BankID 不公布价格。费用通常按身份识别和签名的次数计算，私营部门的价格由市场竞争决定。[4] Didit 收费 $0.20。
BankID 返回哪些数据？
返回 12 位 personnummer、全名、名字和姓氏、签名和一份 OCSP 响应，另附设备数据和可选的风险等级。不返回地址、国籍或人像照片。[6]
BankID 能核验用户年龄吗？
能。personnummer 编码了出生日期，因此每次登录都能得知用户年龄。未成年人能否使用 BankID 取决于其银行是否允许，通常从 13 岁或 18 岁起，并需父母同意。[5][6]
外国人能使用 BankID 吗？
只有持有瑞典 personnummer 并在发行银行开立账户的人才能使用。BankID 新闻列表公布，自 2026年5月5日起，已登记的非瑞典公民可使用欧盟护照续期。没有 personnummer 的访客需要采用其他途径，例如证件核验。[5][9]
BankID 的保证级别是什么？
实质级（Substantial）。BankID 属于瑞典 eID 方案，该方案于 2020年12月14日依据 eIDAS 完成通报；方案的通报级别为实质级和高级，DIGG 将 BankID 的手段列为实质级和瑞典信任级别 3。[10][11]
在瑞典，BankID 足以满足反洗钱客户尽职调查要求吗？
它是一种认可的手段。反洗钱法第3章第7条允许使用 eIDAS 电子身份识别来核验身份。在此之外，仍须进行筛查、风险评估和持续监控。[13]
BankID 集成需要多长时间？
截至 2026年10月5日，BankID 未公布接入周期。直接集成需要银行合同、通过 BankID Keygen 获取的依赖方证书，以及自行实现二维码、轮询和提示码处理；通过经销商则可用一个 API 替代上述工作。[4][6]
上线前能测试 BankID 吗？
能。BankID 开发者网站在 API 参考文档旁提供测试门户。[6] 上线仍需与银行或经销商签订合同，若采用直接集成，还需通过 BankID Keygen 申请依赖方证书。[4] 也要测试对未知提示码的处理，因为 BankID 可能在不事先通知的情况下新增提示码。[6]
SverigeID 会取代 BankID 吗？
不会。SverigeID 是将于 2026年12月1日开放的国家 e-ID，是对 BankID 和 Freja 的补充。它已获批瑞典信任级别 4，但截至 2026年10月5日，尚未列入欧盟已通报方案清单。[11][17]
资料来源
- BankID 数据一览，BankID，2025 年数据。
- 历史，BankID。
- 法律法规，BankID。
- 企业接入，BankID。
- 获取 BankID，BankID。
- /collect API 参考文档，BankID Developers，2026年10月5日查阅。
- 人脸识别作为额外控制，BankID 新闻，2026年8月。
- 投票站使用数字身份证，BankID 新闻，2026 年。
- 新闻，BankID，2026 年条目。
- eIDAS 下预通报和已通报 eID 方案概览，欧盟委员会，2026年10月5日查阅。
- 已批准的 e-ID 和证明功能，DIGG。
- 关于电子身份识别，DIGG。
- Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism，Sveriges riksdag。
- Spellagen (2018:1138)，法规文本，载于 lagen.nu。
- (EU) 2024/1624 号条例 (AMLR)，第 22 条，EUR-Lex。
- 最终报告：AMLR 第 28(1) 条项下的 RTS 草案，AMLA，2026年9月30日。
- Statlig e-legitimation，SverigeID，瑞典警察局。
在 eID 验证页面比较各国 eID，或先了解什么是 eID 验证。