CustomerAuthenticatedLoginWith2FA

Mutation que valida as credenciais do cliente (identificador + senha) e, somente em caso de sucesso, dispara o envio de uma chave de acesso para o e-mail cadastrado do cliente. Ela não emite CustomerAccessToken: o retorno é apenas o e-mail para o qual a chave foi enviada, que deve ser repassado à mutation CustomerAuthenticateAccessKey para concluir a autenticação.

É usada quando a loja precisa de um login com dois fatores — senha e chave de acesso enviada por e-mail — em um único ponto de entrada, no lugar de CustomerAuthenticatedLogin. Aplicações típicas: lojas com exigência de segurança reforçada ou conformidade que não podem autenticar apenas com senha, e lojas com a configuração LoginSegundoFatorObrigatorio ativa, onde os demais métodos de login passam a ser recusados. A mutation está sempre disponível, independentemente dessa configuração.

Argumentos

Parâmetros de CustomerAuthenticateInput

Retorno — TwoFactorLoginChallenge

Exemplo — login por e-mail

mutation {
  customerAuthenticatedLoginWith2FA(
    input: { input: "[email protected]", password: "senha-do-cliente" }
    recaptchaToken: "03AGdBq26..."
  ) {
    email
  }
}

{
  "data": {
    "customerAuthenticatedLoginWith2FA": {
      "email": "[email protected]"
    }
  }
}

Exemplo — login por CPF

mutation {
  customerAuthenticatedLoginWith2FA(
    input: { input: "12345678900", password: "senha-do-cliente" }
    recaptchaToken: "03AGdBq26..."
  ) {
    email
  }
}

{
  "data": {
    "customerAuthenticatedLoginWith2FA": {
      "email": "[email protected]"
    }
  }
}

Exemplo — com variáveis

mutation CustomerAuthenticatedLoginWith2FA(
  $input: String!
  $password: String!
  $recaptchaToken: String
) {
  customerAuthenticatedLoginWith2FA(
    input: { input: $input, password: $password }
    recaptchaToken: $recaptchaToken
  ) {
    email
  }
}

{
  "input": "[email protected]",
  "password": "senha-do-cliente",
  "recaptchaToken": "03AGdBq26..."
}

SDK TypeScript

Disponível na versão full do SDK a partir da v1.2.0.

const { data } = await sdk.customer.authenticateWith2FA(
  input,          // e-mail, CPF ou CNPJ
  password,       // senha
  recaptchaToken  // opcional
);

// data.email → e-mail de destino da chave de acesso

Erros