Get Transaction Receipt
This endpoint returns the receipt (PDF + metadata) of one of the BaaS TEDs that QI Tech executed for an integralization. A single integralization cycle (investor payment → fees → disbursement) can produce multiple TEDs — pick the one you want with the transaction_type query parameter.
If multiple TEDs of the same type were executed for the same integralization (e.g., several extraordinary_event_payment), this endpoint returns only the most recent one. To list all of them, use Get Integralization Transactions.
Get Transaction Receipt (GET)
Request
Path Params
| Field | Type | Description | Characters |
|---|---|---|---|
INTEGRALIZATION-KEY | string | Unique integralization key (UUID v4). | 36 |
Query Params
| Field | Type | Description | Required |
|---|---|---|---|
transaction_type | string | Type of TED to fetch. transaction_type enums | Yes |
Response
Response Body
{
"transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec",
"transaction_amount": 12345.67,
"transaction_status": "settled",
"pdf_encoded_string": "JVBERi0xLi4u..."
}
Response Body Params
| Field | Type | Description |
|---|---|---|
transaction_key | string | Unique BaaS-side TED key — same value returned by consulta-transacoes-integralizacao. |
transaction_amount | number | TED amount as recorded by QI Tech. |
transaction_status | string | TED status on the BaaS side (e.g., settled, paid). |
pdf_encoded_string | string | Bank receipt as a base64-encoded string. Decode it to retrieve the PDF. |
transaction_type enums
| Enum | Description |
|---|---|
disbursement | TED that delivered the issuer's net amount to the issuer's bank account. |
bookkeeping_fee_internal | TED to QI CTVM for the internal bookkeeping fee. |
bookkeeping_fee_external | TED to the client's external bookkeeping account. |
structuring_fee | TED to the client's structuring account. |
extraordinary_event_payment | TED to an investor for an extraordinary settlement event. |
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | HTTPMissingParam | The transaction_type query parameter was not provided. |
| 400 | HTTPInvalidParam | transaction_type is not one of the allowed values. |
| 404 | ACL000004 (IntegralizationTransactionNotFound) | No TED of the requested type exists for the integralization, OR the integralization was never settled (no TEDs). |
A 404 with ACL000004 is returned identically in every scenario (unknown key, never-settled integralization, or missing TED type) — by design, we don't differentiate the cases. To check whether an integralization exists, list its transactions first.