curl
curl -X GET 'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/notes/?limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.transactions.notes.list(
"abcdef12-3456-7890-abcd-ef1234567890",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.transactions.notes.list("abcdef12-3456-7890-abcd-ef1234567890")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Transactions.Notes.ListAutoPaging(ctx, "abcdef12-3456-7890-abcd-ef1234567890", didit.TransactionsNotesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.transactions().notes().list("abcdef12-3456-7890-abcd-ef1234567890")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->transactions->notes->list('abcdef12-3456-7890-abcd-ef1234567890') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.transactions.notes.list("abcdef12-3456-7890-abcd-ef1234567890").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Transactions.Notes.ListAsync("abcdef12-3456-7890-abcd-ef1234567890"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"uuid": "c1111111-2222-4333-8444-555555555555",
"note": "Customer confirmed the withdrawal by phone.",
"actor_email": null,
"actor_name": null,
"metadata": {
"mentioned_emails": [
"analyst@example.com"
]
},
"created_at": "2026-10-16T10:05:12.481203Z"
},
{
"uuid": "c2222222-3333-4444-8555-666666666666",
"note": "Status changed from IN_REVIEW to APPROVED. Reason: Source of funds verified",
"actor_email": "reviewer@example.com",
"actor_name": "Alex Reviewer",
"metadata": {
"type": "status_change",
"previous_status": "IN_REVIEW",
"new_status": "APPROVED",
"reason_code": "SOF_VERIFIED",
"reason_label": "Source of funds verified"
},
"created_at": "2026-10-15T17:22:40.103911Z"
},
{
"uuid": "c3333333-4444-4555-8666-777777777777",
"note": "Large withdrawal to a new wallet: check the source of funds.",
"actor_email": null,
"actor_name": "Rule Engine",
"metadata": {
"rule_uuid": "d1111111-2222-4333-8444-555555555555",
"source": "rule_action"
},
"created_at": "2026-10-15T08:42:12.004518Z"
}
]
}交易
列出交易备注 API
通过 Didit 管理 API 列出受监控交易的备注,按最新排序,包括 API 备注、审核员备注、规则备注和状态变更,支持 limit 与 offset 分页。
GET
/
v3
/
transactions
/
{transaction_id}
/
notes
/
curl
curl -X GET 'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/notes/?limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.transactions.notes.list(
"abcdef12-3456-7890-abcd-ef1234567890",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.transactions.notes.list("abcdef12-3456-7890-abcd-ef1234567890")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Transactions.Notes.ListAutoPaging(ctx, "abcdef12-3456-7890-abcd-ef1234567890", didit.TransactionsNotesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.transactions().notes().list("abcdef12-3456-7890-abcd-ef1234567890")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->transactions->notes->list('abcdef12-3456-7890-abcd-ef1234567890') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.transactions.notes.list("abcdef12-3456-7890-abcd-ef1234567890").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Transactions.Notes.ListAsync("abcdef12-3456-7890-abcd-ef1234567890"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"uuid": "c1111111-2222-4333-8444-555555555555",
"note": "Customer confirmed the withdrawal by phone.",
"actor_email": null,
"actor_name": null,
"metadata": {
"mentioned_emails": [
"analyst@example.com"
]
},
"created_at": "2026-10-16T10:05:12.481203Z"
},
{
"uuid": "c2222222-3333-4444-8555-666666666666",
"note": "Status changed from IN_REVIEW to APPROVED. Reason: Source of funds verified",
"actor_email": "reviewer@example.com",
"actor_name": "Alex Reviewer",
"metadata": {
"type": "status_change",
"previous_status": "IN_REVIEW",
"new_status": "APPROVED",
"reason_code": "SOF_VERIFIED",
"reason_label": "Source of funds verified"
},
"created_at": "2026-10-15T17:22:40.103911Z"
},
{
"uuid": "c3333333-4444-4555-8666-777777777777",
"note": "Large withdrawal to a new wallet: check the source of funds.",
"actor_email": null,
"actor_name": "Rule Engine",
"metadata": {
"rule_uuid": "d1111111-2222-4333-8444-555555555555",
"source": "rule_action"
},
"created_at": "2026-10-15T08:42:12.004518Z"
}
]
}
备注记录了交易的分析师时间线,与审核员在 交易详情 中 备注 下看到的列表相同。您可以使用 创建交易备注 添加自己的备注,并使用 获取交易 读取交易本身,包括其
activities。
当 actor_name 为 Rule Engine 时,该备注来自 Didit:可能是规则的 add_note 操作,也可能是为处于 AWAITING_USER 状态的交易创建用户操作验证会话时出现问题(会话无法创建,或 Didit 改用了其他工作流)。授权
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
路径参数
Didit 交易 UUID:由 POST /v3/transactions/ 和 GET /v3/transactions/ 返回的 uuid。不接受您自己的 txn_id。
查询参数
每页备注数量。默认为 50。非正整数值将回退为 50;大于 1000000 的值将返回 400。
必填范围:
1 <= x <= 1000000要返回的第一条备注的从零开始的位置。建议跟随 next。非整数值将回退为 0;大于 1000000 的值将返回 400。
必填范围:
0 <= x <= 1000000最后修改于 2026年11月7日