如何在您的软件中集成BIC验证API
1. 什么是BIC验证API？
在处理电汇付款和处理IBAN相关交易时，提供正确的SWIFT / BIC代码对支付费用至关重要.我们公司已经从S.W.I.F.T SCRL获得官方BIC目录许可，以提供一种自动验证BIC的强大而简单的方法。 此服务允许您将BIC代码目录查找集成到软件中以用于内部目的
BIC验证API具有SWIFTRef Data Inside。 BIC数据经S.W.I.F.T许可使用SCRL。保留数据库权利2026
2. 特点
BIC验证API主要功能：- 根据BIC检索有关银行的信息
- 按银行名称和国家的一部分搜索BIC目录。
- 在BIC目录中搜索历史记录。
- 使用完整和简化的API响应，以便于集成。
3. API使用
BIC 验证API基于REST，支持简单的HTTP GET或POST请求。接受的参数列于下表:
| 字段名称 | 长度 | 类型 | 描述 |
|---|---|---|---|
| bic | 11 | 字符串 | 若需查找的BIC / SWIFT代码。 可以是8或11个字符 |
| bank_name | 256 | 字符串 | 在BIC目录中执行搜索的银行名称的一部分。 |
| 国家 | 2 | 字符串 | 按银行名称搜索时需要两个字母的国家代码。 |
| api_key | 128 | 字符串 | 您的个人API密钥。 |
| 格式 | 4 | 字符串 | 需要指定返回数据的格式。目前支持的值：json，xml |
| 限制 | 整数 | 可选：可用于限制按银行名称搜索时的结果数。 | |
| hist | 整数 | 可选：可用于显示数据库中用于银行和bic搜索的历史记录。 |
4. api xml响应结构
您可以下载api响应的 xsd架构返回字段的详细说明可在下表中查看：
| 字段 name | type | length | always present | description |
|---|---|---|---|---|
| modification flag | 字母 | 1 | 是 | 在delta文件中： •A（补充） •M（修改） •D（删除）完整文件： •A（附加） |
| 已更改字段 | 数字 | 186 | 无 | 记录由于修改记录或作为新事件的结果而更改的字段（或tag）。 一个或多个列被指示为数字序列，每个数字表示从先前记录实例或先前事件改变的列 示例"6,7,8,9" 这意味着事件类型，事件日期，BIC8和BRANCH BIC都有 变化。 以下字段在更改字段中被排除： •记录键 •已更改字段 •修改标志 |
| 记录键 | 字母数字 | 12 | 是 | 文件中记录的唯一键 每条记录代表BIC生命周期中的事件 分配后，记录键永远不会改变。 |
| 以往记录键 | 字母数字 | 12 | 无 | 先前链接的事件记录键 所有相关事件均相互链接，可以使用此信息进行定位。 |
| 下一个记录键 | 字母数字 | 12 | 无/ td> | 下一个相关链接事件的记录键 所有相关事件均相互链接，可以使用此信息找到 |
| 事件类型 | 字母 | 32 | 是 | 与过去、现在或将来会发生的事件相关的BIC或更改说明。 事件类型：. • BIC已发布 • BIC已过期 • BIC 激活FIN • BIC 激活 FA • BIC 激活 IA • BIC停用 FIN • BIC 停用 FA • BI停用 IA • BIC 停用 • BIC 暂停 • BIC 重新激活 • BIC 已发布 • BIC 法定名称已更改 • BIC机构名称已更改 • BIC 地址已更改 • FIN S服务代码已更改 最后更新日期是BIC序列的最后一行（即最近的条目）. 添加新事件时，修改标记和已更改 字段列将在之前的相关事件中更新。 |
| 事件日期 | 字母数字 | 8 | 是 | 事件日期/td> |
| BIC8 | 字母数字 | 8 | 是 | BIC (机构、国家和政党后缀）其中: •政党前缀(4 char) •国家代码(2 char) •政党后缀(2 char) |
| 分支 BIC | 字母数字 | 3 | 是 | 与8字符BIC相关联的BIC分支标识符。如果不存在分支标识符，则使用XXX。 |
| BIC | 字母数字 | 11 | 是 | 完整的BIC：8个字符的BIC和分支标识符 |
| 记录状态 | 字母 | 1 | 是 | 表示记录的状态： • [C]=当前代表链中的最新事件，直到发布日期，不包括[F]事件 • [H]=事件链中的历史记录 • [F]=将在目录的发布日期之后发生的Future事件。之前指出的[C] 当前事件将在[F] 未来事件中指定的日期之前有效. 对于未来事件，日期表示更改何时为有效格式. |
| 可操作的活动记录/td> | 字母 | 1 | 是 | 同一BIC有多个记录。 该字段指示相同BIC的哪些记录是操作上有效的BIC并且应该被使用 • [Y] 操作有效 • [N] 操作无效 对于每个唯一的BIC，有一个记录条目指示激活状态（Y）. 具有[H]等级状态的记录将始终指示[N]。 [C] 现有的记录可能表示[Y]或[N]。 带[F]的记录将始终指示[N]。 |
| 子类型指标 | 任何类型 | 4 | 是 | 实体的业务类型。 仅为具有BIC的记录提供子类型指示符。. |
| SWIFT FIN | 字母 | 1 | 是 | 实体与 FIN的连接状态: • [Y] 连接到 FIN • [N] 未连接到f FIN |
| SWIFT FA | 字母 | 1 | 是 | S>通过FileAc实体的可达性状态t: • [Y] 连接到 FileAct • [N] 未连接到FileAct |
| SWIFT IA | 字母 | 1 | 是 | 通过interAct实体的可达性状态: • [Y] 连接到InterAct • [N] 未连接到InterAct |
| 合法名称 | 任何 | 105 | 无 | 机构法定名称 |
| I机构名称 | 任何 | 105 | 是 | 机构交易名称（公布名称） |
| 机构类型 | 字母 | 12 | 是 | 主要从事金融中介和/或辅助金融活动的组织 机构类型： • 金融 •非金融 |
| 实体类型 | 字母 | 16 | 是 | 标识金融实体的类型： •法律实体 •分支 •运作 |
| RE街道地址1 | 任何 | 35 | 无 | [注册]街道名称 |
| 街道地址2 | 任何 | 35 | 无 | [注册]街道号码 |
| RE街道地址3 | 任何 | 35 | 无 | [注册]建筑物，建筑物名称，楼层 |
| 街道地址4 | 任何 | 35 | 无 | [注册]区域 |
| RE 城市 | 任何 | 35 | 无 | [注册]机构/分支机构的城市名称/td> |
| RE CPS | 任何 | 90 | 无 | [Registration] 注册]所有者机构/分支机构的县，省，州或其他行政区域< |
| RE邮政编码 | 任何 | 15 | 无 | [注册]机构/分行的邮政编码 |
| RE POB号码 | 任何 | 35 | 无 | 逗号分隔的字段，包含机构/分支机构的pob编号和相关的邮政编码。 例如点击 "pob 103352,40024" 这允许客户使用完整的pob地址： POB 103352 40024，杜塞尔多夫（市） |
| 运营街道地址1 | 任何 | 35 | 无 | [运营]街道名称 |
| 运营街道地址2 | 任何 | 35 | 无 | [运营]街道号码 |
| 运营街道地址3 | 任何 | 35 | 无 | [运营]建筑物，建筑物名称，楼层 |
| 运营街道地址4 | 任何 | 35 | 无 | [运营]区域 |
| 运营城市 | 任何 | 35 | 无 | [运营]机构/分支机构的城市名称 |
| 运营cps | 任何 | 90 | 无 | [运营]所有者机构/分支机构的县，省，州或其他行政区域 |
| 运营邮编 | 任何 | 15 | 无 | [运营]机构/分行的邮政编码 |
| 运营POB号码 | 任何 | 35 | 无 | 逗号分隔的字段，包含机构/分支机构的POB编号和相关的邮政编码。 例如点击 "POB 103352,40024" 这允许客户使用完整的POB地址： POB 103352 40024，杜塞尔多夫（市） |
| 任何 | 35 | 无 | [分行]街道名称 | |
| 任何 | 35 | 无 | [分行]街道号码 | |
| 任何 | 35 | 无 | [分行]建筑物，建筑物名称，楼层 | |
| 任何 | 35 | 无 | [分行]区域 | |
| 分行城市 | 任何 | 35 | 无 | [分行]机构/分行的城市名称 |
| 分行CPS | 任何 | 90 | 无 | [分行]所有者机构/分支机构的县，省，州或其他行政区域 |
| 分行邮政编码 | 任何 | 15 | 无 | [分行]机构/分行的邮政编码 |
| 分行POB号码 | 任何 | 35 | 无 | 逗号分隔的字段，包含机构/分支机构的POB编号和相关的邮政编码。 例如点击 "POB 103352,40024" 这允许客户使用完整的POB地址： POB 103352 40024，杜塞尔多夫（市） |
| 分行信息< | 任何 | 70 | 无 | 分行信息 这是由其所属的金融机构提供的分支机构的自由文本描述。目前，仅有具有BIC条目才可提供，并且只有当有关金融机构需要提供这些额外信息时才会提供。该信息来自BIC目录。 |
| 国家名称 | 任何 | 70 | 是 | SO 3166中指明的机构/分支机构的国家名称 |
| ISO国家代码 | 字母 | 2 | 是 | 机构/分支机构所在国家的ISO 3166-1 alpha-2代码 |
| 位置代码 | 任何类型 | 1 | 是 | 包含位置（正式位于BIC标准的第7位：2009） 例如: • 在FR, 巴黎BIC= P •在 BE, 布鲁塞尔BIC= B •在 US, 东部海岸的BIC= 3 |
| FIN服务代码 | 任何类型 | 60 | 无 | FIN服务代码（也称为增值服务代码）。服务代码仅适用于包含BIC的记录。 该字段最多可包含20个三字符代码，按字母顺序排列。 |
| 记录键 BDP | 字母数字 | 12 | 无 | 文件中Bank Directory Plus记录的唯一键。 |
| 字段 A | 任何 | 1 | 无 | 保留供将来使用 |
| 字段 B | 任何 | 64 | 无 | 保留供将来使用 |
| 字段 C | 任何 | 128 | 无 | 保留供将来使用 |
| 字段 D | 任何 | 256 | 无 | 保留供将来使用 |
| 字段 E | 任何 | 11 | 无 | 保留供将来使用 |
| 字段 F | 任何 | 12 | 无 | 保留供将来使用 |
用于BIC搜索的API的XML回复示例将是:
<result> <bicdata> <row> <modification_flag>A</modification_flag> <changed_字段>34</changed_字段> <record_key>BP0000004OQQ</record_key> <previous_record_key>BP00000030XZ</previous_record_key> <next_record_key/> <event_type>BIC ADDRESS CHANGED</event_type> <event_date>20150606</event_date> <bic8>BARCGB22</bic8> <branch_bic>XXX</branch_bic> <bic>BARCGB22XXX</bic> <record_status>C</record_status> <operationally_active_record>Y</operationally_active_record> <subtype_indicator>SUPE</subtype_indicator> <swift_fin>Y</swift_fin> <swift_fa>N</swift_fa> <swift_ia>N</swift_ia> <legal_name>BARCLAYS BANK PLC</legal_name> <institution_name>BARCLAYS BANK PLC</institution_name> <institution_type>FINANCIAL</institution_type> <entity_type>Legal Entity</entity_type> <re_street_address_1>1, CHURCHILL PLACE</re_street_address_1> <re_street_address_2/> <re_street_address_3/> <re_street_address_4/> <re_city>LONDON</re_city> <re_cps/> <re_zip_code>E14 5HP</re_zip_code> <re_pob_number/> <op_street_address_1>1 CHURCHILL PLACE</op_street_address_1> <op_street_address_2/> <op_street_address_3/> <op_street_address_4/> <op_city>LONDON</op_city> <op_cps>LONDON E14 5HP</op_cps> <op_zip_code/> <op_pob_number/> <br_street_address_1/> <br_street_address_2/> <br_street_address_3/> <br_street_address_4/> <br_city/> <br_cps/> <br_zip_code/> <br_pob_number/> <branch_information>(ALL U.K. OFFICES)</branch_information> <country_name>UNITED KINGDOM</country_name> <iso_country_code>GB</iso_country_code> <location_code>2</location_code> <fin_service_codes>EBAERPFINSCOSTGTGT</fin_service_codes> <record_key_bdp>BD00000006FO</record_key_bdp> <field_a/> < field _b/> < field _c/> < field _d/> < field _e/> < field _f></ field _f> </row> </bicdata> <errors/> </result>
5. API错误
如果出现错误，API将返回包含错误消息的XML响应。在XML响应中返回
您可以在下面找到可能返回的所有可能错误消息的说明：
| 状态代码 | 类型 | 描述 |
|---|---|---|
| 301 | 帐户错误 | API密钥无效 |
| 302 | 帐户错误r | 订阅已过期 |
| 303 | 帐户错误 | 无查询 |
| 304 | 帐户错误 | 您无法访问此API |
| 401 | 输入错误 | 接受SWIFT长度8或11个字符' |
| 402 | 输入错误r | 银行名称无效！ 银行搜索最少4个字符。
允许的字符a-z，A-Z，0-9，[空格]! |
| 403 | 输入错误 | 国家/地区代码不正确！ 允许为2个字母的国家/地区代码。 示例： UK, DE, FR |