基金账户间转账

此功能允许在同一基金下的两个账户之间进行金额转账，从来源账户扣款并向目标账户入账。

---

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

字段	类型	描述
fund_class_key	string	QI CTVM 中基金唯一标识键

Body Params

字段	类型	描述
amount	int	待转账金额，以分为单位（例如：15000 = 150.00 巴西雷亚尔）
description	string	转账描述
origin_key	string	转账的唯一幂等键（UUID v4），由集成方在每次请求时生成
origin_type	string	转账来源类型。必须以 manual_transfer 发送
source_account_key	string	待扣款账户（来源）的唯一标识键
target_account_key	string	待入账账户（目标）的唯一标识键
transfer_type	string	转账类型。接受 pix 或 wire_transfer，受来源账户所支持的类型限制

注意

为接收转账结果，需要配置转账确认的 webhook。