Webhook de conclusão de Agendamento Ted

Após a conclusão de um agendamento Ted, um webhook será enviado ao parceiro integrador com o resultado.

Atenção!

Os webhooks da QI Tech não devem ser mapeados de forma restrita. Campos adicionais podem ser incluídos aos payloads dos webhooks retornados em nossas APIs.

Webhook Request Body

Request Body: Agendamento Concluído e Enviado

{
  "webhook_type": "baas.ted.ted_schedule.completed",
  "webhook_datetime": "2021-10-22T20:30:23.459Z",
  "data": {
    "request_control_key": "b8eb663e-10fe-4729-9db5-8f8c93de5001",
    "schedule_key": "0c9091ab-079b-4a43-8b3d-d4ba36a23883",
    "schedule_batch_key": null,
    "schedule_status": "sent",
    "target_account": {
      "account_branch": "0001",
      "account_digit": "8",
      "account_number": "1234567",
      "owner_document_number": "***91111***",
      "owner_person_type": "natural",
      "owner_name": "Conta manual geral",
      "account_type": "checking_account",
      "ispb": "99999004"
    },
    "transaction_amount": 2.0,
    "rejection_info": null,
    "schedule_date": "2024-07-10",
    "updated_at": "2024-07-10T16:19:38Z",
    "created_at": "2024-06-10T11:17:28Z",
    "schedule_transfers": [
      {
        "request_control_key": "12723821-41d5-496b-b66c-fb7188f50fc1",
        "ted_key": "91028dfa-43a2-4665-adf2-0bd4571f6f0d",
        "created_at": "2024-07-10T16:19:38Z",
        "ted_status": "sent",
        "fee_amount": 2.00
      }
    ]
  }
}

Request Body: Agendamento Concluído e Rejeitado

{
  "webhook_type": "baas.ted.ted_schedule.completed",
  "webhook_datetime": "2021-10-22T20:30:23.459Z",
  "data": {
    "request_control_key": "b8eb663e-10fe-4729-9db5-8f8c93de5001",
    "schedule_key": "0c9091ab-079b-4a43-8b3d-d4ba36a23883",
    "schedule_batch_key": null,
    "schedule_status": "sent",
    "target_account": {
      "account_branch": "0001",
      "account_digit": "8",
      "account_number": "1234567",
      "owner_document_number": "***91111***",
      "owner_person_type": "natural",
      "owner_name": "Conta manual geral",
      "account_type": "checking_account",
      "ispb": "99999004"
    },
    "transaction_amount": 2.0,
    "rejection_info": {
      "error_code": "TED000103",
      "error_description": "The maximum number of failed transfer attempts has been reached",
      "error_translation": "Número máximo de tentativas de transferência foi atingida",
      "rejection_reason": "max_tries_exceeded"
    },
    "schedule_date": "2024-07-10",
    "updated_at": "2024-07-10T16:19:38Z",
    "created_at": "2024-06-10T11:17:28Z",
    "schedule_transfers": [
      {
        "ted_key": "907e38c5-5700-492f-a181-8f651317458b",
        "created_at": "2024-07-10T16:19:38Z",
        "ted_status": "rejected",
        "fee_amount": 2.00
      },
      {
        "ted_key": "356f8855-8f8d-4aaa-8e8c-1287e363d143",
        "created_at": "2024-07-10T17:19:38Z",
        "ted_status": "rejected",
        "fee_amount": 2.00
      },
      {
        "ted_key": "c51cc7ee-d966-4bbb-8405-4850b90b43f8",
        "created_at": "2024-07-10T18:19:38Z",
        "ted_status": "rejected",
        "fee_amount": 2.00
      }
    ]
  }
}

Webhook Body Param

Campo	Tipo	Descrição	Max. Caracteres
webhook_type	string	Um enumerador que define o tipo de evento sendo reportado	23
webhook_datetime	string	Data e hora do envio do webhook	20
request_control_key	uuidv4	Chave única de identificação da request utilizada pelo cliente no formato uuid v4.	36
schedule_key	string	Chave única de identificação do agendamento	36
schedule_batch_key	string	Chave única de identificação do lote de agendamento	36
schedule_status	string	Status do agendamento	Enumerador schedule_status
target_account	object	Conta destino do agendamento	Objeto target_account
transaction_amount	number	Valor da transferencia	10
schedule_transfers	array	Lista de tentativas de transferências realizadas pelo agendamento	lista de Objeto schedule_transfer
schedule_date	string	Data a ser realizada a transação.	10
rejection_info	object	Objeto com informaçôes sobre o evento de rejeição
updated_at	string	Data e hora da última atualização do agendamento.	20
created_at	string	Data e hora de criação do agendamento.	20

Ted Schedule Status

Enumerador	Descrição
scheduled	Transação agendada
sent	Agendamento concluído e enviado com sucesso. Estado final
rejected	Agendamento rejeitado durante criação ou execução. Estado final
cancelled	Agendamento cancelado por solicitação de cliente. Estado final
pending_2fa_approval	Pendente de aprovação por autenticação de dois fatores
waiting_batch_approval	Agendamento criado e vinculado a um lote aguardando aprovação por autenticação de dois fatores

Objeto Schedule Transfer

Campo	Tipo	Descrição	Caracteres
ted_key	uuidv4	Chave única de identificação da transferência Ted no sistema QI.	36
ted_status	string	Status da transação.	Enumeradores ted_status
fee_amount	number	Valor da transferencia	10
created_at	string	Data e hora de criação da transação	20

Enumerador Ted Status

Enumerador	Descrição
sent	Transação enviada com sucesso. Estado final
rejected	Transação rejeitada durante execução. Estado final
pending	Transação pendente de conclusão. Estado Transitório

Objeto target_account

Campo	Tipo	Descrição	Caracteres
account_branch	string	Agência da conta	6
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	150
owner_person_type	enumerator	Identificador de que o dono da conta enviada é uma pessoa física ou jurídica	Enumerador owner_person_type
owner_name	string	Nome do titular da conta	150
account_type	enumerator	Tipo da conta	Enumerador account_type
ispb	string	Código de oito dígitos que identifica os bancos no sistema de transferência de reserva do Banco Central	8

Enumerador owner_person_type

Enum	Description
natural	Pessoa física
legal	Pessoa jurídica

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