Transfer Between Fund Accounts

This feature allows transferring amounts between two accounts belonging to the same fund, debiting the source account and crediting the target account.

---

Request

ENDPOINT

/transfer/fund_class/FUND_CLASS_KEY/internal_transfer

METHOD

POST

Request Body

{
    "amount": 15000,
    "description": "Internal transfer",
    "origin_key": "<UUID>",
    "origin_type": "manual_transfer",
    "source_account_key": "<UUID>",
    "target_account_key": "<UUID>",
    "transfer_type": "pix"
}

Response

STATUS

201

Response Body

{
    "internal_transfer_key": "<UUID>",
    "internal_transfer_status": "created"
}

Path Params

Field	Type	Description
fund_class_key	string	Unique identifier key for the fund at QI CTVM

Body Params

Field	Type	Description
amount	int	Amount to be transferred, in cents (e.g., 15000 = BRL 150.00)
description	string	Transfer description
origin_key	string	Unique idempotency key for the transfer (UUID v4), generated by the integrator on each request
origin_type	string	Transfer origin type. Must be sent as manual_transfer
source_account_key	string	Unique identifier key for the account to be debited (source)
target_account_key	string	Unique identifier key for the account to be credited (target)
transfer_type	string	Transfer type. Accepts pix or wire_transfer, limited to what the source account supports

Attention

To receive the transfer result, it is necessary to configure the transfer confirmation webhook.