Confirmar MFA de uma transação pendente

Utilizado apenas quando authChallenge.type === 'MFA_TOTP'. Em caso de sucesso, retorna o payload do QR Pix para exibir ao seu usuário.

Request

string

obrigatório

Sua API key.

string

obrigatório

ID da transação retornado por POST /v1/laas/transactions/initiate.

string

obrigatório

Código TOTP de 6 dígitos do app autenticador do usuário.

Request

{
  "totpCode": "482910"
}

Response

string

ID da transação.

string

PENDING_PAYMENT — Pix está pronto, aguardando o pagamento do usuário.

string

String do Pix Copia e Cola. Codifique como QR code e exiba ao usuário.

string

Timestamp ISO 8601 de quando o QR Pix expira (tipicamente 15 minutos).

Response (200)

{
  "success": true,
  "data": {
    "transactionId": "tx_1719000000_xyz",
    "status": "PENDING_PAYMENT",
    "pixPayload": "00020101021226890014br.gov.bcb.pix...",
    "pixExpiry": "2026-07-01T18:15:00.000Z"
  }
}

Response (422 — wrong code)

{
  "success": false,
  "error": {
    "code": "MFA_INVALID_CODE",
    "message": "The TOTP code is invalid or has expired. Try again."
  }
}

Após 5 tentativas consecutivas de TOTP com falha, a transação é bloqueada e o usuário precisa iniciar uma nova. A Supercosmos registra um alerta interno.

Visão geral

KYC

Transações

Acesso

Request

Response

​Request

​Response

Request

Response