curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/accounts/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_accounts(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listAccounts("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListAccounts(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListAccountsParams{})
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().listAccounts("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listAccounts('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_accounts("11111111-2222-3333-4444-555555555555")
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.ListAccountsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"name": "Cuenta negocio",
"product": "Cuenta corriente empresas",
"type": "current",
"usage": "business",
"currency": "EUR",
"holder_name": "EMPRESA DE EJEMPLO SL",
"holders": [
{
"name": "EMPRESA DE EJEMPLO SL",
"role": "holder"
}
],
"identifiers": {
"iban": "ES0000000000000000001332",
"bic": "XXXXESBBXXX",
"account_number": null,
"sort_code": null,
"other": []
},
"account_ref": "ar_f3c1a85e9d27b640c8e1",
"account_ref_previous": null,
"status": "open",
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"sync": {
"last_synced_at": "2026-11-21T12:04:40Z",
"status": "ok",
"history_requested_from": "2025-11-21",
"history_available_from": "2026-01-02",
"pending_supported": true
},
"history_coverage": {
"requested_from": "2025-11-21",
"oldest_booking_date": "2026-01-02",
"covered_ranges": [
{
"from": "2026-01-02",
"to": "2026-11-21"
}
],
"missing_ranges": [
{
"from": "2025-11-21",
"to": "2026-01-01"
}
],
"status": "partial",
"extended_auth_used": false
}
}
],
"next_cursor": null
}
账户与交易
列出银行账户 API:连接中的账户
Didit 的列出账户端点可返回用户在某个连接中共享的全部账户,包括个人账户和企业账户。
GET
/
v3
/
bank
/
connections
/
{id}
/
accounts
/
curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/accounts/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_accounts(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listAccounts("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListAccounts(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListAccountsParams{})
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().listAccounts("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listAccounts('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_accounts("11111111-2222-3333-4444-555555555555")
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.ListAccountsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"name": "Cuenta negocio",
"product": "Cuenta corriente empresas",
"type": "current",
"usage": "business",
"currency": "EUR",
"holder_name": "EMPRESA DE EJEMPLO SL",
"holders": [
{
"name": "EMPRESA DE EJEMPLO SL",
"role": "holder"
}
],
"identifiers": {
"iban": "ES0000000000000000001332",
"bic": "XXXXESBBXXX",
"account_number": null,
"sort_code": null,
"other": []
},
"account_ref": "ar_f3c1a85e9d27b640c8e1",
"account_ref_previous": null,
"status": "open",
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"sync": {
"last_synced_at": "2026-11-21T12:04:40Z",
"status": "ok",
"history_requested_from": "2025-11-21",
"history_available_from": "2026-01-02",
"pending_supported": true
},
"history_coverage": {
"requested_from": "2025-11-21",
"oldest_booking_date": "2026-01-02",
"covered_ranges": [
{
"from": "2026-01-02",
"to": "2026-11-21"
}
],
"missing_ranges": [
{
"from": "2025-11-21",
"to": "2026-01-01"
}
],
"status": "partial",
"extended_auth_used": false
}
}
],
"next_cursor": null
}
Didit 的账户列表 endpoint(List Accounts)会返回用户在某个连接中共享的全部账户,包括个人账户和企业账户。
只要连接仍然存在,账户 ID 就保持不变,包括续期后。
授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
最后修改于 2026年11月22日