批准双因素身份验证交易

Request

ENDPOINT

/account/ACCOUNT_KEY/pix_transfer/PIX_TRANSFER_KEY/validate_token

MÉTODO

PUT

路径参数

字段	类型	描述	字符数
account_key	uuidv4	账户唯一标识键。	36
pix_transfer_key	uuidv4	Pix 交易唯一标识键。	36

通过 Email 和 SMS 进行身份验证

Request Body

{
  "token": "329adf"
}

通过设备进行身份验证

要批准并完成设备身份验证，请求必须以空 payload 发送。验证在内部进行，请求体中不需要额外信息。需要注意的是，此端点只能在交易申请发起后使用。

Request Body

{

}

Body 参数

字段	类型	描述	字符数
token	string	发送给账户交易审批人的身份验证代码，SMS 或 email TFA 必填	6

Response

STATUS

201

Response Body: 转账已发送

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "end_to_end_id": "E32402502202405081755SxyT2DDcVwc",
  "pix_transfer_status": "sent",
  "created_at": "2021-10-22T20:30:23.459Z",
  "transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec"
}

STATUS

202

Response Body: 转账待处理

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "end_to_end_id": "E32402502202405081755SxyT2DDcVwc",
  "pix_transfer_status": "pending",
  "created_at": "2021-10-22T20:30:23.459Z"
}

STATUS

4xx

Response Body: 转账已拒绝

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {
    "pix_transfer_data": {
      "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
      "pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
      "end_to_end_id": "E32402502202405081755SxyT2DDcVwc",
      "pix_transfer_status": "rejected",
      "created_at": "2021-10-22T20:30:23.459Z"
    }
  }
}

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	Erro de Schema
404	PXT000023	Outgoing PIX Transfer Not Found	Pix transfer key {pix_transfer_key} was not found	Transferência PIX de saída com chave {pix_transfer_key} não foi encontrada
400	PXT000175	Invalid Status	Pix transfer not in pending_2fa_approval status	Pix transfer não está pendente de aprovação por two factor authentication
400	PXT000182	Bad Request	The given Pix transfer is tied to a batch. It cannot be individually approved. Please approve batch	A Pix transfer enviada está ligada a um lote. Ela não pode ser individualmente aprovada. Por favor aprove o lote
400	PXT000174	Error Sending Token	An error occurred while sending token and its being investigated	Um erro ocorreu ao enviar token e está sendo investigado
400	PXT000173	Incorrect Token	Token sent does not match expected	Token enviado não condiz com, o esperado
400	PXT000172	Token Expired	Token has expired. Resend token or recreate transfer	Token expirado. Reenvie token ou recrie a transferência
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
406	PXT000103	request_control_key must be a valid uuid v4 string	request_control_key was not accepted for not being a valid uuid v4 string	request_control_key não foi aceito por não ser uma palavra uuid v4 válida
400	PXT000048	Bad Request	Emoji not allowed in pix message.	Emoji não é permitido na mensagem pix.
400	PXT000104	Invalid Transaction Amount	Transaction amount of {transaction_amount} is not valid. It must be a positive value with at maximum 2 decimal places	O valor de transação {transaction_amount} não é válido. Deve ser um valor positivo com no máximo duas casas decimais
404	PXT000004	Account not found	Account not found for: {account_datum}	Conta não encontrada para: {account_datum}
400	PXT000003	Account is Closed	Account {account_key} is closed.	Conta {account_key} está fechada.
422	PXT000092	Invalid Account Type	Pix is not yet implemented for non-checking or non-escrow account types	Transações Pix não estão implementadas para conta que não sejam escrow ou livres
403	PIT000001	User is not allowed to do this transaction		Usuário não tem autorização para fazer essa transação
400	PXT000010	Account is Blocked	Account {account_key} is blocked.	Conta {account_key} está bloqueada.
400	PIT000003	Bad Request	Insufficient account balance for transfer and fee amount.	Saldo de conta insuficiente para a transferência e a taxa.
400	PXT000118	Requester is not Pix Participant	The requester sent an alias key but is not a indirect pix participant	O requisitante enviou uma alias key no entanto não é um participante do pix indireto
404	PXT000120	Alias sent not found	Alias key attached to this account not found	Alias key vinculada à conta não encontrada
406	PXT000105	Invalid end_to_end_id	The end_to_end_id sent {end_to_end_id} is not valid.	O end_to_end_id enviado {end_to_end_id} não é válido.
400	PXT000108	Bad Request	Billing account closed or blocked	Conta de cobrança encerrada ou bloqueada
400	PXT000079	Bad Request	Insufficient billing account balance for fee.	Saldo de conta de cobrança insuficiente para a taxa.
400	PIT000004	Bad Request	Transaction amount is over limit.	O total da transferência é superior ao limite.
400	PXT000109	Bad Request	request_control_key {request_control_key} already in use	request_control_key {request_control_key} já utilizada
400	PXT000189	Token Required	A token is required for SMS or email validation.	Um token é necessário para validação via SMS ou email.