查询交易凭证

此端点用于获取 QI Tech 为某次认缴执行的某笔 BaaS TED 的凭证（PDF 与元数据）。一次认缴流程（投资者付款 → 费用 → 拨付）可能产生多笔 TED，您通过 transaction_type 查询参数选择需要的那一笔。

如果同一次认缴中存在多笔同类型的 TED（例如多笔 extraordinary_event_payment），此端点仅返回最新的一笔。如需列出全部，请使用 查询认缴交易列表。

查询交易凭证 (GET)

Request

ENDPOINT

/account_liquidation/integralization/INTEGRALIZATION-KEY/transaction_receipt

MÉTODO

GET

Path Params

字段	类型	描述	字符数
`INTEGRALIZATION-KEY`	string	认缴的唯一键（UUID v4）。	36

Query Params

字段	类型	描述	是否必填
`transaction_type`	string	要查询的 TED 类型。transaction_type 枚举值	是

Response

STATUS

200

Response Body

{
    "transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec",
    "transaction_amount": 12345.67,
    "transaction_status": "settled",
    "pdf_encoded_string": "JVBERi0xLi4u..."
}

Response Body Params

字段	类型	描述
`transaction_key`	string	BaaS 侧 TED 的唯一键 — 与 `consulta-transacoes-integralizacao` 返回的值相同。
`transaction_amount`	number	QI Tech 记录的 TED 金额。
`transaction_status`	string	TED 在 BaaS 侧的状态（如 `settled`、`paid`）。
`pdf_encoded_string`	string	base64 编码的银行凭证字符串，解码后即可获取 PDF。

transaction_type 枚举值

枚举	描述
`disbursement`	将发行人净额拨付到发行人银行账户的 TED。
`bookkeeping_fee_internal`	支付给 QI CTVM 的内部簿记费 TED。
`bookkeeping_fee_external`	支付给客户外部簿记账户的 TED。
`structuring_fee`	支付给客户结构化账户的 TED。
`extraordinary_event_payment`	因特殊清算事件支付给投资者的 TED。

错误

HTTP	代码	触发条件
400	`HTTPMissingParam`	未提供 `transaction_type` 查询参数。
400	`HTTPInvalidParam`	`transaction_type` 不在允许的取值范围内。
404	`ACL000004` (`IntegralizationTransactionNotFound`)	不存在所请求类型的 TED，或该认缴从未完成清算（无任何 TED 记录）。

备注

404 与 ACL000004 在所有场景下（未知键、从未清算的认缴、缺失的 TED 类型）的返回相同 — 这是设计意图，不区分具体场景。如果需要确认认缴是否存在，请先查询其交易列表。

查询交易凭证 (GET)​

Request​

Path Params​

Query Params​

Response​

Response Body Params​

transaction_type 枚举值​

错误​