Pular para o conteúdo principal

Webhook após finalização de envio de TED

Webhook informará caso uma transação TED tenha sido devolvida.

Webhook Request Body

Webhook Body: TED Rejeitada
{
"webhook_type": "baas.ted.outgoing_ted",
"webhook_datetime": "2021-10-22T20:30:23.459Z",
"data": {
"request_control_key": "6e290347-330d-4b3a-8ebb-2ac217ad6eb3",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"account_key": "fc6862c4-2b20-4057-8063-b8809866e494",
"created_at": "2021-10-22T20:30:23.459Z",
"ted_status": "sent",
"transaction_amount": 126.97,
"fee_amount": 0.0,
"target_account": {
"account_branch": "0001",
"account_digit": "6",
"account_number": "78340",
"ispb": "12345678",
"owner_document_number": "32402502000135",
"owner_name": "QI Tech"
},
"refusal_reason": {
"refusal_code": 1,
"enumerator": "conta_destinatario_encerrada",
"description": "Conta Destinatária do Crédito Encerrada"
}
}
}

Webhook Body Param

CampoTipoDescriçãoMax. Caracteres
webhook_typestringUm enumerador que define o tipo de evento sendo reportado23
webhook_datetimestringData e hora do envio do webhook20
request_control_keystringChave única de identificação da request utilizada pelo cliente no formato uuid v436
ted_keystringChave única de identificação da transferência TED36
created_atstringData e hora de criação da transação24
ted_statusstringStatus da transação TEDEnumerador ted_status
transaction_amountnumberValor da transferência10
fee_amountnumberValor da taxa cobrada pela transferencia35
target_accountObjectConta destino - Só deve ser enviada em transações do tipo "manual"Objeto target_account
refusal_reasonObjectMotivo da recusa de acordo com o padrão do Banco CentralObjeto refusal_reason

Enumerador ted_status

EnumeradorDescrição
sentTransferência TED realizada com sucesso.
pendingTransferência TED pendente.
rejectedTransferência TED rejeitada.
returnedTransferência TED devolvida.

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

Objeto refusal_reason

CampoTipoDescriçãoCaracteres
bacen_code *stringCódigo de recusa Bacen3
enumerator *stringEnumerador da recusa Bacen100
description *stringDescrição da recusa Bacen100

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

Webhook após o recebimento de TED

Webhook informará sobre o status final da transação TED.

Webhook Request Body

Request Body: TED Recebida
{
"webhook_type": "baas.ted.incoming_ted",
"webhook_datetime": "2021-10-22T20:30:23.459Z",
"data": {
"request_control_key": "6e290347-330d-4b3a-8ebb-2ac217ad6eb3",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"account_key": "fc6862c4-2b20-4057-8063-b8809866e494",
"created_at": "2021-10-22T20:30:23.459Z",
"ted_status": "received",
"transaction_amount": 126.97,
"fee_amount": 0.0,
"source_account": {
"account_branch": "0001",
"account_digit": "6",
"account_number": "78340",
"ispb": "12345678",
"owner_document_number": "32402502000135",
"owner_name": "QI Tech"
},
"refusal_reason": {}
}
}

Webhook Body Param

CampoTipoDescriçãoMax. Caracteres
webhook_typestringUm enumerador que define o tipo de evento sendo reportado23
webhook_datetimestringData e hora do envio do webhook20
ted_keystringChave única de identificação da transferência TED36
created_atstringData e hora de criação da transação100
ted_statusstringStatus da transação TEDEnumerador ted_status
transaction_amountnumberValor da transferência10
fee_amountnumberValor da taxa cobrada pela transferencia35
target_accountObjectConta destino - Só deve ser enviada em transações do tipo "manual"Objeto target_account
refusal_reasonObjectMotivo da recusa de acordo com o padrão do Banco CentralObjeto refusal_reason

Enumerador ted_status

EnumeradorDescrição
receivedTransferência TED realizada com sucesso.
pendingTransferência TED pendente.
rejectedTransferência TED rejeitada.

Objeto target_account

CampoTipoDescriçãoCaracteres
account_branch *stringAgência.10
account_digit *stringDígito da conta10
account_number *stringNúmero da conta.10
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

Objeto refusal_reason

CampoTipoDescriçãoCaracteres
bacen_code *stringCódigo de recusa Bacen3
enumerator *stringEnumerador da recusa Bacen100
description *stringDescrição da recusa Bacen100

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