Transferência entre contas do fundo
Esse recurso permite realizar uma transferência de valores entre duas contas pertencentes ao mesmo fundo, debitando a conta de origem e creditando a conta de destino.
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Escrita |
URL base de cada host: Ambientes (Hosts).
Request
Path Params
| Campo | Tipo | Descrição |
|---|---|---|
fund_class_key | string | Chave única identificadora do fundo na QI DTVM |
{
"amount": 15000,
"description": "Transferência para a conta de cobrança",
"origin_key": "3f2b8c1d-4e5a-4b6c-8d7e-9f0a1b2c3d4e",
"origin_type": "manual_transfer",
"source_account_key": "9c1d0c18-01ea-4c32-a878-1c6391f9aa44",
"target_account_key": "6b5335ed-1380-4348-9520-8998ca6e388b",
"transfer_type": "pix"
}
Body Params
| Campo | Tipo | Obrigatoriedade | Descrição |
|---|---|---|---|
amount | integer | obrigatório | Valor a ser transferido, em centavos (ex.: 15000 = R$ 150,00). Deve ser maior que zero. |
description | string | obrigatório | Descrição da transferência. Até 255 caracteres. |
origin_key | string | obrigatório | Seu identificador (UUID) desta transferência. Uma segunda transferência com o mesmo origin_key é recusada (TSF000022) enquanto a primeira não estiver cancelada. |
origin_type | string | obrigatório | Envie manual_transfer. |
target_account_key | string | obrigatório | Chave da conta a ser creditada (destino). |
source_account_key | string | opcional | Chave da conta a ser debitada (origem). Quando omitida, é usada a conta principal do fundo. |
transfer_type | string | opcional | pix ou wire_transfer (TED), limitado ao que a conta de origem suporta (veja account_configuration em Recuperando Informações da Conta). Padrão: wire_transfer. |
As duas contas precisam pertencer ao fundo, estar abertas e ser diferentes entre si.
Response
{
"internal_transfer_key": "1d4c2b7a-8e9f-4a0b-b1c2-d3e4f5a6b7c8",
"internal_transfer_status": "pending_validation"
}
| Campo | Tipo | Descrição |
|---|---|---|
internal_transfer_key | string | Identificador da transferência na QI Tech. |
internal_transfer_status | string | Status da transferência no momento da criação: pending_validation. |
Como confirmar a transferência
Esta transferência não envia webhook e não há endpoint para consultar seu status. Para confirmar que ela foi efetivada, consulte o extrato das contas em Recuperando Transações de uma Conta: o débito aparece na conta de origem e o crédito na conta de destino, com a description que você enviou.
Em caso de erro, reenvie a requisição: uma transferência já criada é recusada com TSF000022, e assim você não transfere duas vezes. Veja Reenvio e duplicidade.
Erros
| Status | Código | Quando acontece |
|---|---|---|
| 409 | TSF000022 | Já existe transferência com este origin_key. Não reenvie. |
| 400 | TSF000008 | amount igual ou menor que zero. |
| 400 | TSF000012 | origin_type inválido. |
| 400 | TSF000030 | transfer_type inválido. |
| 400 | TSF000035 | A conta de origem não aceita este transfer_type. |
| 400 | TSF000049 | O caixa do fundo já foi fechado no dia. |
| 400 | TSF000020 | Uma das contas não pertence ao fundo. |
| 400 | TSF000018 | Uma das contas não está aberta. |
| 400 | TSF000036 | Conta de origem igual à de destino. |
| 404 | TSF000005 | A fund_class_key não existe. |
| 403 | TSF000034 | O fundo não pertence à sua gestora. |
| 400 | QIT000001 | Corpo inválido (campo obrigatório ausente, tipo errado ou campo não aceito). |
Erros de autenticação, permissão e host: veja Erros da API.