跳转到主要内容
POST
curl

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

transaction_id
string<uuid>
必填

拥有该转账的 Didit 稳定交易 UUID。

请求体

以 JSON 格式发送,或以 multipart/form-data 格式发送并将附件放入 files 中。

kind
enum<string>
默认值:MESSAGE
可用选项:
MESSAGE,
DOCUMENT_REQUEST
body
string

MESSAGE 所必需,除非附加了文件。

Maximum string length: 5000
requested_documents
string[]

DOCUMENT_REQUEST 所必需(至少一个),且仅允许在该类型中使用。

Maximum array length: 10
Maximum string length: 255
reply_to
string<uuid> | null

同一笔转账的消息。携带证件的回复可满足其所响应的证件请求。

files
file[]

仅限 multipart。最多 5 个文件,每个文件不超过 10 MB。

Maximum array length: 5

响应

存储的消息。

id
string<uuid>
kind
enum<string>
可用选项:
MESSAGE,
DOCUMENT_REQUEST
direction
enum<string>

OUTBOUND 是读取方自身发送的内容。在 pickup 门户中,方向是来自交易对手一方。

可用选项:
INBOUND,
OUTBOUND
author
string

在其所属方写入该内容的主体:控制台用户的邮箱、API 密钥标签,或对方 VASP 的名称。

body
string
requested_documents
string[]

DOCUMENT_REQUEST 所请求的内容,以请求者的措辞描述。

reply_to
string<uuid> | null
fulfilled_at
string<date-time> | null

一旦对 DOCUMENT_REQUEST 的回复携带了证件,便会在该请求上设置。

attachment
object | null

附加到消息的证件,像任何其他交易证件一样存储。

created_at
string<date-time>
最后修改于 2026年11月7日