2FA da Braintree: como configurar um app autenticador
Pela equipe Novaz · Atualizado em 6 de novembro de 2026
Passos do Novaz verificados na versão 1.0.5
Traduzido do guia em inglês. No site do serviço, os botões e menus podem ter nomes um pouco diferentes em português.
Nesta página
A Braintree, o gateway de pagamentos que o PayPal opera como PayPal Braintree, dá a cada lojista um Control Panel (painel de controle) em que a equipe consulta transações, faz reembolsos e gerencia chaves de API. A autenticação de dois fatores (2FA) lá não é opcional. Desde setembro de 2023, todo usuário da Braintree precisa ativá-la antes de usar o Control Panel, e quem ainda não ativou recebe um assistente de configuração logo depois de entrar (Braintree).
A 2FA é configurada por usuário, não por empresa. Cada pessoa da sua equipe entra com as próprias credenciais e configura o próprio segundo fator (Braintree). As suas opções são um app autenticador ou mensagens de texto, e você pode acrescentar uma chave de segurança física depois que uma delas estiver ativada. Este guia usa o Authenticator App - Novaz no iPhone, mas qualquer app autenticador funciona do mesmo jeito.
Como verificamos este guia: os passos da Braintree vêm dos próprios artigos de suporte da Braintree em developer.paypal.com, com links abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta da Braintree, então um rótulo pode ser um pouco diferente. Os passos do Novaz foram conferidos no app, versão 1.0.5.
Entrar com o PayPal
A Braintree permite usar o seu nome de usuário e a sua senha do PayPal no Control Panel. Se você passar a fazer isso, as suas configurações de 2FA da Braintree não são levadas junto, e você configuraria a 2FA do lado do PayPal (Braintree). Os passos abaixo são para usuários que entram com credenciais da Braintree. Sandbox e produção são ambientes separados, que podem ter logins diferentes, então talvez você precise fazer isso em cada um (Braintree).
Ative a 2FA com um app autenticador
Se o assistente de configuração aparecer quando você entrar, siga-o. Para começar a configuração por conta própria, a Braintree descreve estes passos (Braintree):
- Entre no Control Panel e selecione o ícone de usuário no canto superior direito.
- Escolha My User (meu usuário) e role até Two-Factor Authentication (autenticação de dois fatores).
- Selecione Enable (ativar) e digite a sua senha.
- A Braintree mostra um QR code. No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para ele. Se o Control Panel estiver aberto no mesmo iPhone, faça uma captura de tela, toque em + e depois em Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
- Digite o código que o Novaz mostra para concluir.
Ignore o link Use SMS As Primary (usar SMS como principal) na mesma tela. Ele torna as mensagens de texto o seu método principal no lugar do app.
O artigo da Braintree não fala de uma chave em texto para digitar no lugar de escanear, e não diz quantos dígitos os códigos têm nem com que frequência mudam. Escanear o QR code é o caminho seguro, já que ele passa essas configurações para o Novaz.
Quando a Braintree pede um código
Você precisa de um segundo fator toda vez que entra no Control Panel. A Braintree os pede em uma ordem fixa: uma chave de segurança física, se você cadastrou uma, depois o app autenticador, depois um código por mensagem de texto (Braintree).
Se não conseguir acessar o seu app autenticador no login, selecione Text a code instead (enviar um código por SMS) para receber um código por mensagem de texto. Para comparar os dois métodos, veja App autenticador ou SMS.
Sem códigos de backup
O artigo da Braintree não fala de códigos de backup nem de recuperação. As suas alternativas são a opção por mensagem de texto e as pessoas da sua conta que podem redefinir a sua 2FA, descritas abaixo. Sem um backup do Novaz (Backup no iCloud ou um arquivo de backup), as chaves dele só existem no seu iPhone, então ter um segundo método que você ainda consiga acessar importa.
Se a Braintree recusar o seu código
A ajuda da Braintree não trata de códigos de app recusados. Confira o relógio do iPhone: Ajustes > Geral > Data e Hora > Ajustar Automaticamente. O Novaz avisa quando o relógio está defasado em 15 segundos ou mais. Outras causas estão em Código do autenticador não funciona?
Trocar de celular
Desde setembro de 2023, você não pode desativar a 2FA por conta própria. Em vez disso, My User tem uma opção Reset 2FA (redefinir a 2FA) para quando você troca de número de telefone ou de app autenticador (Braintree):
- Abra My User pelo ícone de usuário e role até Two-Factor Authentication.
- Selecione Reset 2FA, digite a sua senha e siga os passos para escanear um novo QR code.
A Braintree avisa que, se você confirmar a redefinição e não terminar, vai ter que configurar a 2FA de novo em My User ou no próximo login. Faça isso enquanto ainda tem o celular antigo. Com um backup no iCloud ou um arquivo de backup do Novaz, você pode restaurar as suas contas no iPhone novo; sem isso, vai adicionar a Braintree no novo do zero. Veja Como transferir o seu app autenticador para um iPhone novo.
Se você perder o autenticador
Tente Text a code instead primeiro. Se isso também não funcionar, peça a um Account Admin (administrador da conta) da sua conta da Braintree para desativar a 2FA para você: no ícone de engrenagem, Team (equipe), o seu usuário e depois Disable (desativar) na seção Two Factor Authentication. Só usuários com a função Account Admin podem fazer isso. A configuração da 2FA será pedida de novo no seu próximo login (Braintree).
Se nenhum admin puder ajudar, ou se você for o único admin, a Braintree diz para entrar em contato com a equipe de suporte pelo formulário Get Help (obter ajuda) (Braintree). A Braintree não diz que comprovação pede nem quanto tempo isso leva. Para os passos gerais, veja Perdeu o celular com o seu app autenticador?
