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.

---

Request

ENDPOINT

/transfer/fund_class/FUND_CLASS_KEY/internal_transfer

MÉTODO

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

Campo	Tipo	Descrição
fund_class_key	string	Chave única identificadora do fundo na QI CTVM

Body Params

Campo	Tipo	Descrição
amount	int	Valor a ser transferido, em centavos (ex.: 15000 = R$ 150,00)
description	string	Descrição da transferência
origin_key	string	Chave única de idempotência da transferência (UUID v4), gerada pelo integrador a cada solicitação
origin_type	string	Tipo de origem da transferência. Deve ser enviado como manual_transfer
source_account_key	string	Chave única identificadora da conta a ser debitada (origem)
target_account_key	string	Chave única identificadora da conta a ser creditada (destino)
transfer_type	string	Tipo de transferência. Aceita pix ou wire_transfer, limitado ao que a conta de origem suporta

Atenção

Para receber o resultado da transferência, é necessário a configuração do webhook de confirmação da transferência.