跳到主要内容

请求双因素身份验证 TED 调度

请求​

ENDPOINT
/account/ACCOUNT_KEY/ted_schedule
方法
POST
Request Body
{
  "request_control_key": "0c3d2a3e-c121-464e-b5a4-8e69e0c17bbd",
  "target_account": {
    "account_branch": "0001","account_number": "92796","account_digit": "1",
    "owner_document_number": "23599885000192","owner_name": "Titular da Conta",
    "ispb": "12345678","account_type": "checking_account"
  },
  "transaction_amount": 8.86,
  "schedule_date": "2024-12-01",
  "tfa_info": {
    "approver_document_number": "98765432100",
    "contact_type": "email"
  }
}

Body Params​

字段类型描述字符数
request_control_key *string客户使用的 uuid v4 格式的请求唯一标识键。36
target_account *object目标账户Objeto target_account
transaction_amount *float转账金额10
schedule_date *string执行交易的日期。10
tfa_info *Object包含账户批准人文件号和联系方式的对象。Objeto tfa_info

Objeto tfa_info​

字段类型描述
approver_document_number *string账户批准人的文件号。
contact_type *string与账户批准人的联系方式，可为 sms 或 email

Objeto target_account​

字段类型描述字符数
account_branch *string银行代码（机构代码）。4
account_digit *string账户校验码1
account_number *string账户号码。20
owner_document_number *string账户持有人的 CPF 或 CNPJ（仅数字）。14
owner_name *string账户持有人姓名。50
account_type *string账户类型。Enumerador account_type
ispb *string基于金融机构 CNPJ（8 位数字）。8

Enumerador account_type​

枚举值翻译
checking_account活期账户
deposit_account存款账户
guaranteed_account担保账户
investment_account投资账户
payment_account付款账户
saving_account储蓄账户

响应​

STATUS
202
Response Body: 已创建调度
{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "schedule_key": "f64b3fa7-d09d-4927-ad4f-b966df9fb153",
  "schedule_status": "pending_2fa_approval",
  "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 状态码
status		QI 代码
code		标题
title		描述（英文）
description		描述（葡文）
translation
400QIT000001Bad Requestschema error descriptionSchema Inválido
404TED000006Target account Not FoundTarget account was not found for given parametersConta destino não encontrada para os parâmetros informados
404TED000009Not FoundAccount not found for the given key: {account_key}Conta não encontrada para a chave fornecida: {account_key}
403TED000014Invalid target accountInvalid target accountConta destino inválida
400TED000015Bad RequestAccount blocked or closed can not perform this actionA conta bloqueada ou fechada não pode executar esta ação
400TED000016Bad RequestHub account can not perform this actionA conta hub não pode executar esta ação
403TED000018UnauthorizedProvided account not owned by SELECTED_AGENTConta fornecida não pertencente ao SELECTED_AGENT
400TED000031Bad RequestISPB number {ispb} does not exist or is inactiveISPB {ispb} não existe ou está inativo
400TED000044Invalid Timestamp Format sentGiven parameter is not in the correct format {timestamp_format}Parametro enviado não está no formato correto {timestamp_format}
400TED000046Invalid uuid v4 string sent{key} was not accepted for not being a valid uuid v4 string{key} não foi aceito por não ser uma palavra uuid v4 válida
400TED000054Invalid Transaction AmountTransaction Amount {transaction_amount} is invalidValor de transação {transaction_amount} é inválido
400TED000057Invalid Document NumberGiven {document_number} document number is invalidCPF/CNPJ {document_number} fornecido não é valido
409TED000064Bad Requestrequest_control_key {request_control_key} already in userequest_control_key {request_control_key} já utilizada
400TED000065Bad RequestIt has been identified by request_control_key that this request is already being processedFoi identificado por request_control_key que está requisição está sendo processada
403TED000079No approver permissionGiven document number does not belong to an approver for this accountNúmero de documento enviado não pertence a um aprovador da conta
400TED000080tfa_info is requiredClient must send object tfa_infoCliente deve enviar objeto tfa_info
400TED000081Error occurred while sending tokenAn unexpected error occurred while sending tokenUm erro inexperado ocorreu ao tentar enviar token
400TED000089Invalid Schedule DateSchedule date must be after current date for UTC-3Data de agendamento deve ser após a data atual em UTC-3
400TED000090Invalid Schedule DateSchedule date must be a workdayData de agendamento deve ser um dia útil
400TED000091Target Account and Source Account must be differentTarget Account must not be the same as Source AccountA conta de destino não pode ser a mesma da conta de origem