Approve TED with Two-Factor Authentication

Request

ENDPOINT

/account/ACCOUNT_KEY/ted/TED_KEY/validate_token

METHOD

PUT

Path Params

Field	Type	Description	Characters
account_key	uuidv4	Unique account identification key.	36
ted_key	uuidv4	Unique TED transfer identification key	36

Email and SMS Authentication

Request Body

{
  "token": "329123"
}

Device Authentication

To approve and finalize device authentication, the request must be sent with an empty payload. Validation occurs internally, without the need for additional information in the request body. It's important to note that this endpoint should only be used after the transaction request has been initiated.

Request Body

{

}

Body Params

Field	Type	Description	Characters
token	string	Authentication code sent to the account movement approver mandatory for TFA via SMS or email	6

Response

STATUS

201

Response Body: Transfer Sent

{
  "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: Pending Transfer

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

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

Information

The errors previously listed for perform TED are subject to being returned by this endpoint in addition to the errors listed below.

HTTP Code status	QI Code code	Title title	Description (eng) description	Description (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.