---
updatedAt: 2026-09-01T13:12:51.000Z
agentTools:
  projectIndex: https://wakecommerce.readme.io/llms.txt
---

# 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`](https://wakecommerce.readme.io/docs/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

| Argumento        | Tipo                         | Obrigatório | Descrição                                                                                                                                                               |
| :--------------- | :--------------------------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `input`          | `CustomerAuthenticateInput!` | Sim         | Credenciais do cliente. Mesmo input aceito por `CustomerAuthenticatedLogin`.                                                                                            |
| `recaptchaToken` | `String`                     | Condicional | Token do Google reCAPTCHA. Obrigatório quando o grupo **Autenticação** está ativo na configuração de obrigatoriedade de reCAPTCHA do token do Storefront API utilizado. |

## Parâmetros de CustomerAuthenticateInput

| Campo      | Tipo      | Obrigatório | Descrição                                                                                                     |
| :--------- | :-------- | :---------- | :------------------------------------------------------------------------------------------------------------ |
| `input`    | `String!` | Sim         | Identificador do cliente. Aceita e-mail ou CPF/CNPJ, conforme a configuração `PermitirLoginCPFeCNPJ` da loja. |
| `password` | `String!` | Sim         | Senha do cliente.                                                                                             |

## Retorno — TwoFactorLoginChallenge

| Campo   | Tipo      | Descrição                                                                                                                                                                             |
| :------ | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `email` | `String!` | E-mail para o qual a chave de acesso foi enviada. É o e-mail do cadastro do cliente, que pode ser diferente do identificador usado no login quando a loja permite login por CPF/CNPJ. |

<Callout icon="❗️" theme="error">
  ### **Use sempre o&#x20;**`email`**&#x20;retornado** na chamada seguinte a `CustomerAuthenticateAccessKey`. No login por CPF/CNPJ o identificador digitado pelo cliente não é o e-mail de destino da chave.
</Callout>

## Exemplo — login por e-mail

```graphql Request
mutation {
  customerAuthenticatedLoginWith2FA(
    input: { input: "example@email.com", password: "senha-do-cliente" }
    recaptchaToken: "03AGdBq26..."
  ) {
    email
  }
}
```

<details>
<summary>Response</summary>

```json Response
{
  "data": {
    "customerAuthenticatedLoginWith2FA": {
      "email": "example@email.com"
    }
  }
}
```

</details>

## Exemplo — login por CPF

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

<details>
<summary>Response</summary>

```json Response
{
  "data": {
    "customerAuthenticatedLoginWith2FA": {
      "email": "cliente@email.com"
    }
  }
}
```

</details>

## Exemplo — com variáveis

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

```json Variáveis
{
  "input": "example@email.com",
  "password": "senha-do-cliente",
  "recaptchaToken": "03AGdBq26..."
}
```

## SDK TypeScript

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

```ts
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

| Código   | Mensagem                                              | Situação                                                                                                                                             |
| :------- | :---------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LOG100` | Usuário ou senha inválidos                            | Senha incorreta **ou** identificador inexistente. Os dois casos retornam o mesmo erro, sem distinção, e em nenhum deles a chave de acesso é enviada. |
| `LOG156` | Este tipo de login não está disponível para esta loja | Retornado pelas **demais** mutations de login quando a configuração `LoginSegundoFatorObrigatorio` está ativa. Não é retornado por esta mutation.    |
| —        | Erro de reCAPTCHA obrigatório                         | `recaptchaToken` ausente ou inválido enquanto o grupo Autenticação está ativo para o token utilizado. A senha não é validada.                        |

<Callout icon="🚧" theme="warn">
  ### **Requisitos para funcionar**

  - O tipo de e-mail `LoginChaveAcesso` precisa estar configurado e ativo na loja, pois é ele que entrega a chave de acesso ao cliente.
  - O tema precisa implementar os **dois passos** (senha e, em seguida, chave de acesso). Ligar a configuração `LoginSegundoFatorObrigatorio` sem essa implementação recusa todos os outros métodos de login da loja.
</Callout>