Approve TED Transaction Scheduling with Two-Factor Authentication

Request

ENDPOINT

/account/ACCOUNT_KEY/ted_schedule/SCHEDULE_KEY/validate_token

METHOD

PUT

Path Params

Field	Type	Description	Characters
account_key	uuidv4	Unique account identification key.	36
schedule_key	uuidv4	Unique scheduling identification key.	36

Authentication via Email and SMS

Request Body

{
  "token": "329123"
}

Authentication via Device

To approve and finalize device authentication, the request must be sent with an empty payload. Validation occurs internally, with no additional information required in the request body. Note that this endpoint should only be used after the scheduling request has been initiated.

Request Body

{

}

Body Params

Field	Type	Description	Characters
token	string	Authentication code sent to the account's transaction approver required for TFA via SMS or email	6

Response

STATUS

201

Response Body: Scheduling Approved

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "schedule_key": "f64b3fa7-d09d-4927-ad4f-b966df9fb153",
  "schedule_status": "scheduled",
  "schedule_date": "2024-12-31"
}

STATUS

4xx

Response Body: Error

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

HTTP Code status	QI Code code	Title title	Description (eng) description	Description (ptbr) translation
400	QIT000001	Bad Request	schema error description	Schema Inválido
404	TED000009	Not Found	Account not found for the given key: {account_key}	Conta não encontrada para a chave fornecida: {account_key}
403	TED000018	Unauthorized	Provided account not owned by SELECTED_AGENT	Conta fornecida não pertencente ao SELECTED_AGENT
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	TED000083	Token Expired	Token has expired. Resend token or recreate transfer	Token expirado. Reenvie token ou recrie a transferência
400	TED000084	Incorrect Token	Token sent does not match expected	Token enviado não condiz com, o esperado
400	TED000085	Error Validating Token	An error occurred while validating token and it is being investigated	Um erro ocorreu ao validar token e está sendo investigado
400	TED000086	Invalid Status	Ted not in pending_2fa_approval status	Ted não está pendente de aprovação por autenticação de dois fatores
404	TED000093	TedSchedule not Found	TedSchedule was not found	TedSchedule não encontrada
400	TED000096	Bad Request	Action cannot be taken place as there is currently a pending transfer in progress	A ação não pôde ser completada como há uma transferência pendente
400	TED000099	Invalid Status	Ted Schedule not in pending_2fa_approval status	Agendamento Ted não está pendente de aprovação por autenticação de dois fatores
400	TED000100	Invalid Schedule Date	Schedule must be approved before the scheduled date	Agendamento deve ser aprovado em data anterior à programada para transação