Approve TED Transaction Batch Schedule with Two-Factor Authentication
Request
ENDPOINT
/account/ACCOUNT_KEY/ted_schedule_batch/SCHEDULE_BATCH_KEY/validate_tokenMETHOD
PUTPath Params
| Field | Type | Description | Characters |
|---|---|---|---|
account_key | uuidv4 | Unique account identification key. | 36 |
schedule_batch_key | uuidv4 | Unique batch schedule 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 batch scheduling request has been initiated.
Request Body
{
}
Body Params
| Field | Type | Description | Characters |
|---|---|---|---|
token | string | Authentication code sent to the account transaction approver required for TFA via SMS or email | 6 |
Response
STATUS
201Response Body: Approved Batch Schedule
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"schedule_batch_key": "f64b3fa7-d09d-4927-ad4f-b966df9fb153",
"schedule_batch_status": "approved",
"created_at": "2023-03-13T19:00:28.440Z"
}
STATUS
4xxResponse Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
HTTP Codestatus | QI Codecode | Titletitle | 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 | TED000102 | Invalid Status | Ted Batch not in pending_2fa_approval status | Lote de Ted não está pendente de aprovação por autenticação de dois fatores |
| 404 | TED000103 | ScheduleBatch not Found | Ted Schedule Batch was not found | Agendamento de Ted em lote não encontrado |
| 400 | TED000106 | Invalid Status | ScheduleBatch not in pending_2fa_approval status | Lote Agendamentos de Ted não está pendente de aprovação por autenticação de dois fatores |
| 400 | TED000107 | Schedule Batch could not be approved | ScheduleBatch could not be approved due to current date being equal or after earliest schedule date. Rejecting batch | ScheduleBatch não pode ser aprovada devido a data atual ser superior ou igual à menor schedule_date. Rejeitando lote |