Pular para o conteúdo principal

Realizar Transação Ted em Lote

A QI Tech oferece a possibilidade de realizar várias transações ted com uma única chamada. Nesse sistema, as transações são realizadas de forma assíncrona. Caso na chamada inicial seja retornado um http status 4xx, nenhuma das transações será realizada. Após a solicitação, o parceiro integrador receberá um webhook para cada transação informando o status final da tentativa, podendo ser rejected ou sent.

Request

ENDPOINT
/account/ACCOUNT_KEY/ted_batch
MÉTODO
POST
{
"request_control_key": "6e4fc980-f8a1-4462-b6e2-d8a49f0ac055",
"teds": [
{
"request_control_key": "0c3d2a3e-c121-464e-b5a4-8e69e0c17bbd",
"target_account": {
"account_branch": "0001",
"account_number": "92796",
"account_digit": "1",
"owner_document_number": "23599885000192",
"owner_name": "Titular da Conta",
"ispb": "12345678",
"account_type": "checking_account"
},
"transaction_amount": 8.86
}
]
}

Path Params

CampoTipoDescriçãoCaracteres
account_keyuuidv4Chave única de identificação da conta.36

Body Params

CampoTipoDescriçãoCaracteres
request_control_key *uuidv4Chave única de identificação da request utilizada pelo cliente no formato uuid v4.36
teds *arrayLista de objetos ted vinculados ao lote.lista de Objeto ted

Objeto ted

CampoTipoDescriçãoCaracteres
request_control_key *stringChave única de identificação da request utilizada pelo cliente no formato uuid v4.36
target_account *objectConta de destinoObjeto target_account
transaction_amount *floatValor da transferência10

Objeto target_account

CampoTipoDescriçãoCaracteres
account_branch *stringAgência.4
account_digit *stringDígito da conta1
account_number *stringNúmero da conta.20
owner_document_number *stringCPF ou CNPJ (apenas números) do titular da conta.14
owner_name *stringNome do titular da conta.50
account_type*stringTipo da conta.Enumerador account_type
ispb *stringBase no CNPJ da instituição financeira (8 dígitos).8

Enumerador account_type

EnumeradorTradução
checking_accountconta corrente
deposit_accountconta depósito
guaranteed_accountconta de garantia
investment_accountconta de investimento
payment_accountconta de pagamento
saving_accountconta poupança

Response

STATUS
201
Response Body: Transferência em lote Aprovada
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"ted_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"ted_batch_status": "approved"
}

Enumerador ted_batch_status

EnumeradorDescrição
approvedTransferência em lote aprovada e transações em processo de execução.
rejectedTransferência em lote rejeitada
pending_2fa_approvalAgendamento em lote pendente de aprovação por autenticação de dois fatores
cancelledTransferência em lote cancelada
STATUS
4xx
Response Body: Lote Rejeitado
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {
"ted_batch_data": {
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"ted_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"ted_batch_status": "rejected"
}
}
}
STATUS
4xx
Response Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
Informação

Os erros anteriormente listados para transferência Ted são passiveis de serem retornados por este endpoint.