批准带双因素身份验证的批量交易

Request

ENDPOINT

/account/ACCOUNT_KEY/pix_transfer_batch/PIX_TRANSFER_BATCH_KEY/validate_token

MÉTODO

PUT

路径参数

字段	类型	描述	字符数
account_key	uuidv4	账户唯一标识键。	36
pix_transfer_batch_key	uuidv4	批量 Pix 交易唯一标识键。	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",
  "pix_transfer_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "pix_transfer_batch_status": "approved"
}

STATUS

4xx

Response Body: 转账被拒绝

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {
    "pix_transfer_batch_data": {
      "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
      "pix_transfer_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
      "pix_transfer_batch_status": "rejected"
    }
  }
}

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
404	PXT000178	Pix Transfer Batch not found	A pix_transfer_batch not found	Uma pix_transfer_batch não encontrada
400	PXT000180	Invalid Status	Pix transfer Batch not in pending_2fa_approval status	Pix transfer em lote não está pendente de aprovação por autenticação de dois fatores
400	PXT000171	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	PXT000172	Token Expired	Token has expired. Resend token or recreate transferToken has expired. Resend token or recreate transfer	Token expirado. Reenvie token ou recrie a transferência
400	PXT000173	Incorrect Token	Token sent does not match expected	Token enviado não condiz com, o esperado
400	PXT000189	Token Required	A token is required for SMS or email validation.	Um token é necessário para validação via SMS ou email.