curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/transactions/sync/?cursor=cur_01HZX9K4M2W7B3T8' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.sync_transactions(
"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.syncTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.SyncTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankSyncTransactionsParams{})
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().syncTransactions("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->syncTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.sync_transactions("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.SyncTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"added": [
{
"id": "8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-19",
"value_date": "2026-11-20",
"transaction_date": null,
"effective_date": "2026-11-19",
"amount": "-1210.00",
"currency": "EUR",
"direction": "debit",
"description": "RECIBO SEGURIDAD SOCIAL",
"counterparty": {
"name": "ENTIDAD PUBLICA DE EJEMPLO",
"iban": "ES0000000000000000005766",
"bic": null
},
"remittance": {
"unstructured": [
"RECIBO SEGURIDAD SOCIAL 10/2026"
],
"structured": null,
"reference": "0028123456789"
},
"bank_transaction_code": "PMNT-RDDT-ESDD",
"bank_reference": "2026111900012345",
"identity_quality": "bank_reference",
"end_to_end_id": "NOTPROVIDED",
"mandate_id": "ES-SS-000123",
"creditor_id": "ES00ZZZ00000000",
"merchant_category_code": null,
"exchange": null,
"balance_after": "18250.34",
"category": "taxes_and_social_security",
"first_seen_at": "2026-11-20T06:00:12Z",
"updated_at": "2026-11-20T06:00:12Z"
}
],
"modified": [],
"removed": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"reason": "pending_booked"
}
],
"has_more": false,
"next_page_token": null,
"next_cursor": "cur_01HZX9K4M2W7B3T8",
"reset": false
}
账户与交易
银行交易变更流 API:新增、修改与删除
Didit 的同步交易端点返回自某个游标以来,连接中交易的新增、修改和删除变化。
GET
/
v3
/
bank
/
connections
/
{id}
/
transactions
/
sync
/
curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/transactions/sync/?cursor=cur_01HZX9K4M2W7B3T8' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.sync_transactions(
"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.syncTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.SyncTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankSyncTransactionsParams{})
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().syncTransactions("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->syncTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.sync_transactions("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.SyncTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"added": [
{
"id": "8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-19",
"value_date": "2026-11-20",
"transaction_date": null,
"effective_date": "2026-11-19",
"amount": "-1210.00",
"currency": "EUR",
"direction": "debit",
"description": "RECIBO SEGURIDAD SOCIAL",
"counterparty": {
"name": "ENTIDAD PUBLICA DE EJEMPLO",
"iban": "ES0000000000000000005766",
"bic": null
},
"remittance": {
"unstructured": [
"RECIBO SEGURIDAD SOCIAL 10/2026"
],
"structured": null,
"reference": "0028123456789"
},
"bank_transaction_code": "PMNT-RDDT-ESDD",
"bank_reference": "2026111900012345",
"identity_quality": "bank_reference",
"end_to_end_id": "NOTPROVIDED",
"mandate_id": "ES-SS-000123",
"creditor_id": "ES00ZZZ00000000",
"merchant_category_code": null,
"exchange": null,
"balance_after": "18250.34",
"category": "taxes_and_social_security",
"first_seen_at": "2026-11-20T06:00:12Z",
"updated_at": "2026-11-20T06:00:12Z"
}
],
"modified": [],
"removed": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"reason": "pending_booked"
}
],
"has_more": false,
"next_page_token": null,
"next_cursor": "cur_01HZX9K4M2W7B3T8",
"reset": false
}
Didit 的 Sync Transactions 端点会返回某个连接自指定游标以来发生变化的交易,包括
added、modified 和 removed。
空游标会返回全部交易,并带上 reset: true。
只有在响应中 has_more: false 时,才应存储 next_cursor。
请参阅面向会计的持续银行数据流。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
查询参数
响应
变更列表的一页。
自某个游标之后,连接交易的变更。空游标会将当前所有交易作为 added 返回。同一次读取的所有分页反映同一快照;读取期间发生的变更将在下一次读取中返回。
最后修改于 2026年11月22日