Realizar TED

O recebimento de uma transação TED não é instantânea no sistema financeiro nacional. Ao realizar uma transação TED no sistema QI uma resposta imediata será retornada informando erro, rejeição ou aceite da transferencia. Mesmo que uma transferência tenha sido colocada em sent, a Instituição Financeira recebedora pode recusar a entrada de recurso e realizar a devolução do valor. Neste caso um novo webhook com status de rejected será enviado e o motivo da rejeição retornado no campo refusal_reason.

Débitos na conta fonte da transação serão realizados imediatamente. Isso não significa que o valor foi creditado na conta destino devido aos princípios de transações TED descritos acima. Caso ocorra a rejeição da transação enviada, o valor da transação será creditado novamente à conta fonte.

Request

ENDPOINT

/account/ACCOUNT_KEY/ted

MÉTODO

POST

Request Body

{
  "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
}

Body Params

Campo	Tipo	Descrição	Caracteres
request_control_key *	string	Chave única de identificação da request utilizada pelo cliente no formato uuid v4.	36
target_account *	object	Conta de destino	Objeto target_account
transaction_amount *	float	Valor da transferência	10

Objeto target_account

Campo	Tipo	Descrição	Caracteres
account_branch *	string	Agência.	4
account_digit *	string	Dígito da conta	1
account_number *	string	Número da conta.	20
owner_document_number *	string	CPF ou CNPJ (apenas números) do titular da conta.	14
owner_name *	string	Nome do titular da conta.	50
account_type*	string	Tipo da conta.	Enumerador account_type
ispb *	string	Base no CNPJ da instituição financeira (8 dígitos).	8

Enumerador account_type

Enumerador	Tradução
checking_account	conta corrente
deposit_account	conta depósito
guaranteed_account	conta de garantia
investment_account	conta de investimento
payment_account	conta de pagamento
saving_account	conta poupança

Response

STATUS

201

Response Body

{
  "request_control_key": "0c3d2a3e-c121-464e-b5a4-8e69e0c17bbd",
  "ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "created_at": "2021-10-22T20:30:23.459Z",
  "ted_status": "sent",
  "transaction_amount": 126.97,
  "fee_amount": 0.0,
  "transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec"
}

STATUS

4xx

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

Código HTTP status	Código QI code	Título title	Descrição (eng) description	Descrição (ptbr) translation
400	QIT000001	Bad Request	Schema Error	Erro de Schema
400	TED000066	InvalidUuid	request_control_key was not accepted for not being a valid uuid v4 string	request_control_key não foi aceito por não ser uma palavra uuid v4 válida
400	TED000011	InvalidUuid	Wrong day/time for TED	Dia/hora incorretos para a TED
400	TED000055	Invalid Observation	Observation sent is invalid	Observação enviada é inválida
400	TED000054	Invalid Transaction Amount	Transaction amount of {transaction_amount} is not valid. It must be a positive value with at maximum 2 decimal places	O valor de transação {transaction_amount} não é válido. Deve ser um valor positivo com no máximo duas casas decimais
400	TED000012	Bad Request	The target's length of the account + account_digit cannot be larger than 21	O número de digitos na conta de destino + digito não pode ser maior que 21
400	TED000053	Invalid Target Account Type	Target Account Type {account_type} is invalid	Tipo de conta destino {account_type} é inválido
400	TED000031	Bad Request	ISPB number {ispb} does not exist or is inactive	ISPB {ispb} não existe ou está inativo
400	TED000065	Bad Request	It has been identified by request_control_key that this request is already being processed	Foi identificado por request_control_key que está requisição está sendo processada
403	TED000071	Invalid target account	Invalid target account	Conta destino inválida
400	TED000058	Bad Request	Insufficient account balance for transfer and fee amount	Saldo de conta insuficiente para a transação e a taxa
400	TED000070	Bad Request	Insufficient account balance fee amount in billing account	Saldo de conta centralizadora insuficiente para taxa
400	TED000071	Bad Request	Transaction cannot be made due to already blocked balance	Transação não pode ser feita pois saldo em conta bloqueado
400	TED000068	Bad Request	Transfer rejected by the system	transferêancia foi recusada pelo sistema
404	TED000013	Bad Request	Unable to find source_account_key's account	Não foi possível encontrar a conta com source_account_key fornecido
400	TED000015	Bad Request	Account blocked or closed can not perform this action	A conta bloqueada ou fechada não pode executar esta ação
400	TED000016	Bad Request	Hub account can not perform this action	A conta hub não pode executar esta ação
403	TED000017	Unauthorized	Provided account does not have approval credential for the given person	A conta fornecida não possui credencial de aprovação para a pessoa especificada
403	TED000018	Unauthorized	Provided account not owned by SELECTED_AGENT	Conta fornecida não pertencente ao SELECTED_AGENT
400	TED000060	Bad Request	Billing Account is closed	Conta centralizadora de pagamentos de tarifa fechada
400	TED000061	Bad Request	Billing Account without necessary funds	Conta centralizadora de pagamentos sem saldo necessário
409	TED000064	Bad Request	request_control_key {request_control_key} already in use	request_control_key {request_control_key} já utilizada