curl
curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/transactions/?date_from=2026-01-01&date_to=2026-11-21&status=booked' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_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.listTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListTransactionsParams{})
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().listTransactions("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->listTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_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.ListTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "pending",
"pending_id": null,
"reverses_id": null,
"booking_date": null,
"value_date": null,
"transaction_date": "2026-11-21",
"effective_date": "2026-11-21",
"amount": "-64.90",
"currency": "EUR",
"direction": "debit",
"description": "PAGO TARJETA PAPELERIA CENTRAL",
"counterparty": {
"name": "PAPELERIA CENTRAL",
"iban": null,
"bic": null
},
"remittance": {
"unstructured": [],
"structured": null,
"reference": null
},
"bank_transaction_code": null,
"bank_reference": null,
"identity_quality": "derived",
"end_to_end_id": null,
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": "5943",
"exchange": null,
"balance_after": null,
"category": "office_supplies",
"first_seen_at": "2026-11-21T12:04:40Z",
"updated_at": "2026-11-21T12:04:40Z"
},
{
"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"
},
{
"id": "2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-18",
"value_date": "2026-11-18",
"transaction_date": null,
"effective_date": "2026-11-18",
"amount": "3450.00",
"currency": "EUR",
"direction": "credit",
"description": "TRANSFERENCIA FACTURA 2026-0418",
"counterparty": {
"name": "CLIENTE DE EJEMPLO SL",
"iban": "ES0000000000000000007891",
"bic": null
},
"remittance": {
"unstructured": [
"FRA 2026-0418"
],
"structured": null,
"reference": null
},
"bank_transaction_code": "PMNT-RCDT-ESCT",
"bank_reference": "2026111800009876",
"identity_quality": "bank_reference",
"end_to_end_id": "2026-0418",
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": null,
"exchange": null,
"balance_after": "19460.34",
"category": "income",
"first_seen_at": "2026-11-19T06:00:10Z",
"updated_at": "2026-11-19T06:00:10Z"
}
],
"next_page_token": null,
"has_more": false
}账户与交易
银行交易列表 API:日期范围、已入账与待处理交易
Didit 的 List Transactions 端点可按日期范围读取账户交易,包括已入账和待处理交易,并支持 page-token 分页。
GET
/
v3
/
bank
/
accounts
/
{account_id}
/
transactions
/
curl
curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/transactions/?date_from=2026-01-01&date_to=2026-11-21&status=booked' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_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.listTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListTransactionsParams{})
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().listTransactions("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->listTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_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.ListTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "pending",
"pending_id": null,
"reverses_id": null,
"booking_date": null,
"value_date": null,
"transaction_date": "2026-11-21",
"effective_date": "2026-11-21",
"amount": "-64.90",
"currency": "EUR",
"direction": "debit",
"description": "PAGO TARJETA PAPELERIA CENTRAL",
"counterparty": {
"name": "PAPELERIA CENTRAL",
"iban": null,
"bic": null
},
"remittance": {
"unstructured": [],
"structured": null,
"reference": null
},
"bank_transaction_code": null,
"bank_reference": null,
"identity_quality": "derived",
"end_to_end_id": null,
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": "5943",
"exchange": null,
"balance_after": null,
"category": "office_supplies",
"first_seen_at": "2026-11-21T12:04:40Z",
"updated_at": "2026-11-21T12:04:40Z"
},
{
"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"
},
{
"id": "2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-18",
"value_date": "2026-11-18",
"transaction_date": null,
"effective_date": "2026-11-18",
"amount": "3450.00",
"currency": "EUR",
"direction": "credit",
"description": "TRANSFERENCIA FACTURA 2026-0418",
"counterparty": {
"name": "CLIENTE DE EJEMPLO SL",
"iban": "ES0000000000000000007891",
"bic": null
},
"remittance": {
"unstructured": [
"FRA 2026-0418"
],
"structured": null,
"reference": null
},
"bank_transaction_code": "PMNT-RCDT-ESCT",
"bank_reference": "2026111800009876",
"identity_quality": "bank_reference",
"end_to_end_id": "2026-0418",
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": null,
"exchange": null,
"balance_after": "19460.34",
"category": "income",
"first_seen_at": "2026-11-19T06:00:10Z",
"updated_at": "2026-11-19T06:00:10Z"
}
],
"next_page_token": null,
"has_more": false
}Didit 的 List Transactions endpoint 可按日期范围读取账户的交易记录,包括已入账和待处理的交易,并使用基于 page token 的分页。
金额以十进制字符串返回,银行未提供的字段返回
null。
如需保持副本同步,请使用变更流,而不要重复读取日期范围。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
查询参数
最后修改于 2026年11月22日