批准带双因素身份验证的 Pix 交易预约

Request

ENDPOINT

/account/ACCOUNT_KEY/pix_schedule/SCHEDULE_KEY/validate_token

MÉTODO

PUT

路径参数

字段	类型	描述	字符数
`account_key`	uuidv4	账户唯一标识键。	36
`schedule_key`	uuidv4	预约唯一标识键。	36

通过邮件和短信进行身份验证

Request Body

{
  "token": "329adf"
}

通过设备进行身份验证

要批准并完成设备身份验证，请求必须发送空 payload。验证在内部进行，无需在请求正文中提供额外信息。请注意，仅在预约请求已启动后才应使用此端点。

Request Body

{

}

Body 参数

字段	类型	描述	字符数
`token`	string	发送给账户交易审批人的身份验证码通过短信或邮件进行 TFA 时必填	6

Response

STATUS

201

Response Body: 预约已审批

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "schedule_key": "f64b3fa7-d09d-4927-ad4f-b966df9fb153",
  "schedule_status": "scheduled",
  "schedule_date": "2024-12-31",
  "created_at": "2023-03-13T19:00:28.440Z"
}

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`
400	QIT000001	Bad Request	schema error description	Schema Inválido
404	PSC000001	Account not Found	Account was not found	Conta não encontrada
403	PSC000012	User is not allowed to do this transaction	User is not allowed to do this transaction	Usuário não tem autorização para fazer essa transação
404	PSC000025	PixSchedule not Found	PixSchedule was not found	PixSchedule não encontrada
400	PSC000048	Error occurred while sending token	An unexpected error occurred while sending token	Um erro inesperado ocorreu ao tentar enviar token
400	PSC000049	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	PSC000052	Incorrect Token	Token sent does not match expected	Token enviado não condiz com o esperado
400	PSC000053	Error Sending Token	An error occurred while resending token and its being investigated	Um erro ocorreu ao reenviar token e está sendo investigado
400	PSC000054	Invalid Schedule Date	Schedule must be approved before the scheduled date	Agendamento deve ser aprovado em data anterior à programada para transação
400	PSC000055	Bad Request	Schedule cannot be approved in current status	Agendamento pix não pode ser aprovado no status atual
400	PSC000058	Token Required	A token is required for SMS or email validation.	Um token é necessário para validação via SMS ou email.

Request​

路径参数​

通过邮件和短信进行身份验证​

通过设备进行身份验证​

Body 参数​

Response​