curl
curl 'https://verification.didit.me/v3/bank/institutions/?country=ESP&segment=business&access=ongoing' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_institutions()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listInstitutions();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListInstitutions(ctx, didit.BankListInstitutionsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().listInstitutions();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listInstitutions();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_institutions
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.ListInstitutionsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png",
"timezone": "Europe/Madrid",
"segments": [
"personal",
"business"
],
"access": [
"one_time",
"ongoing"
],
"ongoing_access": true,
"consent_days_max": 180,
"history_days_max": 365,
"pending_transactions": true,
"pending_linkage": false,
"balance_types": [
"booked",
"available"
],
"transaction_fields": [
"value_date",
"counterparty_name",
"counterparty_iban",
"remittance",
"bank_transaction_code",
"bank_reference",
"balance_after"
],
"sign_in": "redirect",
"requires_end_user_email": true,
"corporate_accounts": true,
"bank_account_selection": false,
"separate_history_consent": false,
"reconfirmation": false,
"sync_frequency_hours": null,
"health": "operational"
}
],
"next_cursor": null
}银行与覆盖范围
银行列表 API:机构与能力
Didit 的机构列表接口按国家返回银行及各机构支持的能力,包括业务类型、持续访问、同意期限、历史数据深度和可用字段。
GET
/
v3
/
bank
/
institutions
/
curl
curl 'https://verification.didit.me/v3/bank/institutions/?country=ESP&segment=business&access=ongoing' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_institutions()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listInstitutions();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListInstitutions(ctx, didit.BankListInstitutionsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().listInstitutions();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listInstitutions();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_institutions
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.ListInstitutionsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png",
"timezone": "Europe/Madrid",
"segments": [
"personal",
"business"
],
"access": [
"one_time",
"ongoing"
],
"ongoing_access": true,
"consent_days_max": 180,
"history_days_max": 365,
"pending_transactions": true,
"pending_linkage": false,
"balance_types": [
"booked",
"available"
],
"transaction_fields": [
"value_date",
"counterparty_name",
"counterparty_iban",
"remittance",
"bank_transaction_code",
"bank_reference",
"balance_after"
],
"sign_in": "redirect",
"requires_end_user_email": true,
"corporate_accounts": true,
"bank_account_selection": false,
"separate_history_consent": false,
"reconfirmation": false,
"sync_frequency_hours": null,
"health": "operational"
}
],
"next_cursor": null
}Didit 的 List Institutions endpoint可按国家/地区返回银行列表,并说明每家银行支持的内容:细分、持续访问权限、同意期限、历史数据跨度以及返回的字段。
可使用
country、segment、access 和 q 进行过滤。
参见银行覆盖范围。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
查询参数
最后修改于 2026年11月22日