接入文档
国际 IBAN 验证
验证 IBAN 结构与校验位,返回国家、SEPA、银行、BIC 和账户结构。
Endpoint
POST /v1/iban-validation
Authentication
Use a ToolKK OpenAPI AppKey. APILayer credentials stay on the ToolKK provider gateway.
Billing
A successful call costs 20 coins.
Errors
Invalid input, quota exhaustion, authentication faults, and temporary provider failures return normalized error codes and messages.
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"iban_number": "DE89370400440532013000"
}响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"valid": true,
"iban": "DE89370400440532013000",
"country": "Germany",
"country_code": "DE",
"sepa_country": true,
"bank_name": "Commerzbank",
"bic": "COBADEFFXXX"
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| iban_number | string | DE89370400440532013000 |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.valid | boolean | true |
| data.iban | string | DE89370400440532013000 |
| data.country | string | Germany |
| data.country_code | string | DE |
| data.sepa_country |