Aprovar TED com Autenticação de Dois Fatores

Request

ENDPOINT

/account/ACCOUNT_KEY/ted/TED_KEY/validate_token

MÉTODO

PUT

Path Params

Campo	Tipo	Descrição	Caracteres
account_key	uuidv4	Chave única de identificação da conta.	36
ted_key	uuidv4	Chave única de identificação da transferência TED	36

Autenticação via Email e SMS

Request Body

{
  "token": "329123"
}

Autenticação via Dispositivo

Para aprovar e finalizar a autenticação via dispositivo, a requisição deve ser enviada com um payload vazio. A validação ocorre internamente, sem necessidade de informações adicionais no corpo da requisição. É importante destacar que este endpoint só deve ser utilizado após a solicitação de transação ter sido iniciada.

Request Body

{

}

Body Params

Campo	Tipo	Descrição	Caracteres
token	string	Código de autenticação enviado ao aprovador de movimentações da conta obrigatório para TFA via SMS ou e-mail	6

Response

STATUS

201

Response Body: Transferência Enviada

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec",
  "ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "transaction_amount": 202.01,
  "fee_amount": 10,
  "ted_status": "sent",
  "created_at": "2021-10-22T20:30:23.459Z"
}

STATUS

202

Response Body: Transferência Pendente

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "transaction_amount": 202.01,
  "fee_amount": 10,
  "ted_status": "pending",
  "created_at": "2021-10-22T20:30:23.459Z"
}

STATUS

4xx

Response Body: Transferência Rejeitada

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {
    "ted_data": {
      "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
      "ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
      "transaction_amount": 202.01,
      "fee_amount": 10,
      "ted_status": "rejected",
      "created_at": "2021-10-22T20:30:23.459Z"
    }
  }
}

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 realizar TED são passiveis de serem retornados por este endpoint além dos erros listados abaixo.

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
404	TED000020	Not Found	Ted was not found for the given parameters.	Ted não encontrada para os parâmetros fornecidos.
404	TED000086	Invalid Status	Ted not in pending_2fa_approval status	Ted não está pendente de aprovação por autenticação de dois fatores
400	TED000082	Number of token validation attempts exceeded	The maximum number of failed token validation attempts has been reached	Número máximo de tentativas de validação de token atingida
400	TED000084	Incorrect Token	Token sent does not match expected	Token enviado não condiz com, o esperado
400	TED000083	Token Expired	Token has expired. Resend token or recreate transfer	Token expirado. Reenvie token ou recrie a transferência
400	TED000110	Token Required	A token is required for SMS or email validation.	Um token é necessário para validação via SMS ou email.