跳到主要内容

基金账户间转账

该接口用于在同一基金名下的两个账户之间转账：从源账户扣款，并向目标账户入账。

适用范围
角色主机所需权限
管理人manager-api写入

各主机的 Base URL：环境（主机）。

Request​

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

Path Params​

字段类型描述
fund_class_keystring基金在 QI DTVM 中的唯一标识 key
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​

字段类型是否必填描述
amountinteger必填转账金额，以分为单位（例如：15000 = R$ 150,00）。必须大于零。
descriptionstring必填转账描述。最多 255 个字符。
origin_keystring必填您为该笔转账设定的标识（UUID）。在第一笔转账未取消之前，使用相同 origin_key 的第二笔转账会被拒绝（TSF000022）。
origin_typestring必填请发送 manual_transfer。
target_account_keystring必填入账账户（目标）的 key。
source_account_keystring可选扣款账户（来源）的 key。省略时使用基金的主账户。
transfer_typestring可选pix 或 wire_transfer（TED），限于源账户支持的类型（参见获取账户信息中的 account_configuration）。默认：wire_transfer。

两个账户都必须属于该基金、处于开立状态，且互不相同。

Response​

STATUS
201
Response Body
{
    "internal_transfer_key": "1d4c2b7a-8e9f-4a0b-b1c2-d3e4f5a6b7c8",
    "internal_transfer_status": "pending_validation"
}
字段类型描述
internal_transfer_keystring该转账在 QI Tech 中的标识。
internal_transfer_statusstring创建时的转账状态：pending_validation。

如何确认转账​

该转账不会发送 webhook，也没有查询其状态的端点。如需确认转账已完成，请在获取账户交易记录中查询账户对账单：源账户中会出现扣款，目标账户中会出现入账，描述为您发送的 description。

如发生错误，请重发请求：已创建的转账会被拒绝并返回 TSF000022，因此不会重复转账。参见重发与重复。

错误​

状态码代码触发条件
409TSF000022已存在使用该 origin_key 的转账。请勿重发。
400TSF000008amount 小于或等于零。
400TSF000012origin_type 无效。
400TSF000030transfer_type 无效。
400TSF000035源账户不支持该 transfer_type。
400TSF000049基金当日的现金已关账。
400TSF000020其中一个账户不属于该基金。
400TSF000018其中一个账户未处于开立状态。
400TSF000036源账户与目标账户相同。
404TSF000005该 fund_class_key 不存在。
403TSF000034该基金不属于您的管理人。
400QIT000001请求体无效（缺少必填字段、类型错误或包含不接受的字段）。

认证、权限和主机相关错误：参见 API 错误。