Pular para o conteúdo principal

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.

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiEscrita

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/transfer/fund_class/{fund_class_key}/internal_transfer
MÉTODO
POST

Path Params​

CampoTipoDescrição
fund_class_keystringChave única identificadora do fundo na QI DTVM
Request Body
{
"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​

CampoTipoObrigatoriedadeDescrição
amountintegerobrigatórioValor a ser transferido, em centavos (ex.: 15000 = R$ 150,00). Deve ser maior que zero.
descriptionstringobrigatórioDescrição da transferência. Até 255 caracteres.
origin_keystringobrigatórioSeu identificador (UUID) desta transferência. Uma segunda transferência com o mesmo origin_key é recusada (TSF000022) enquanto a primeira não estiver cancelada.
origin_typestringobrigatórioEnvie manual_transfer.
target_account_keystringobrigatórioChave da conta a ser creditada (destino).
source_account_keystringopcionalChave da conta a ser debitada (origem). Quando omitida, é usada a conta principal do fundo.
transfer_typestringopcionalpix 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​

STATUS
201
Response Body
{
"internal_transfer_key": "1d4c2b7a-8e9f-4a0b-b1c2-d3e4f5a6b7c8",
"internal_transfer_status": "pending_validation"
}
CampoTipoDescrição
internal_transfer_keystringIdentificador da transferência na QI Tech.
internal_transfer_statusstringStatus 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​

StatusCódigoQuando acontece
409TSF000022Já existe transferência com este origin_key. Não reenvie.
400TSF000008amount igual ou menor que zero.
400TSF000012origin_type inválido.
400TSF000030transfer_type inválido.
400TSF000035A conta de origem não aceita este transfer_type.
400TSF000049O caixa do fundo já foi fechado no dia.
400TSF000020Uma das contas não pertence ao fundo.
400TSF000018Uma das contas não está aberta.
400TSF000036Conta de origem igual à de destino.
404TSF000005A fund_class_key não existe.
403TSF000034O fundo não pertence à sua gestora.
400QIT000001Corpo 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.