2FA Braintree : comment configurer une application d’authentification

Braintree, la passerelle de paiement que PayPal exploite sous le nom PayPal Braintree, donne à chaque marchand un Control Panel (panneau de contrôle) où l’équipe consulte les transactions, effectue des remboursements et gère les clés d’API. L’authentification à deux facteurs (2FA) n’y est pas facultative. Depuis septembre 2023, chaque utilisateur de Braintree doit l’activer avant de pouvoir utiliser le Control Panel, et ceux qui ne l’ont pas fait voient un assistant de configuration juste après leur connexion (Braintree).

La 2FA se configure par utilisateur, et non par entreprise. Chaque membre de votre équipe se connecte avec ses propres identifiants et configure son propre second facteur (Braintree). Vous avez le choix entre une application d’authentification et les SMS, et vous pouvez ajouter une clé de sécurité matérielle une fois l’une de ces méthodes activée. Ce guide utilise Authenticator App - Novaz sur iPhone, mais toute application d’authentification fonctionne de la même façon.

Comment nous avons vérifié ce guide : les étapes Braintree proviennent des articles d’assistance de Braintree sur developer.paypal.com, indiqués ci-dessous, que nous avons consultés le 21 octobre 2026. Nous ne les avons pas testées sur un compte Braintree : un libellé peut donc légèrement différer. Les étapes Novaz ont été vérifiées dans l’app, version 1.0.5.

Se connecter plutôt avec PayPal

Braintree vous permet d’utiliser votre nom d’utilisateur et votre mot de passe PayPal pour le Control Panel. Si vous passez à cette méthode, vos paramètres 2FA Braintree ne sont pas repris, et c’est côté PayPal que vous configureriez la 2FA (Braintree). Les étapes ci-dessous concernent les utilisateurs qui se connectent avec des identifiants Braintree. Le sandbox et la production sont des environnements distincts qui peuvent avoir des identifiants différents : vous devrez peut-être faire la configuration dans chacun (Braintree).

Activer la 2FA avec une application d’authentification

Si l’assistant de configuration apparaît à la connexion, suivez-le. Pour lancer vous-même la configuration, Braintree décrit ces étapes (Braintree) :

1. Connectez-vous au Control Panel et sélectionnez l’icône d’utilisateur en haut à droite.
2. Choisissez My User (mon utilisateur) et faites défiler jusqu’à Two-Factor Authentication (authentification à deux facteurs).
3. Sélectionnez Enable (activer) et saisissez votre mot de passe.
4. Braintree affiche un code QR. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers le code. Si le Control Panel est ouvert sur le même iPhone, faites une capture d’écran, touchez +, puis Choisir une photo. Consultez scanner un code QR sur le même iPhone.
5. Saisissez le code affiché par Novaz pour terminer.

Ignorez le lien Use SMS As Primary (utiliser le SMS comme méthode principale) sur le même écran. Il fait des SMS votre méthode principale à la place de l’app.

L’article de Braintree ne mentionne pas de clé sous forme de texte à saisir à la place du scan, et n’indique ni le nombre de chiffres de ses codes, ni leur fréquence de renouvellement. Scanner le code QR est la voie sûre, puisqu’il transmet ces paramètres à Novaz.

Quand Braintree demande un code

Un second facteur vous est demandé à chaque connexion au Control Panel. Braintree les demande dans un ordre fixe : une clé de sécurité matérielle si vous en avez enregistré une, puis l’application d’authentification, puis un code par SMS (Braintree).

Si vous n’avez pas accès à votre application d’authentification au moment de vous connecter, sélectionnez Text a code instead (recevoir plutôt un code par SMS). Pour comparer les deux méthodes, consultez Application d’authentification ou SMS.

Pas de codes de secours

L’article de Braintree ne mentionne ni codes de secours ni codes de récupération. Vos recours sont l’option SMS et les personnes de votre compte qui peuvent réinitialiser votre 2FA, décrites ci-dessous. Sans sauvegarde Novaz (sauvegarde iCloud ou fichier de sauvegarde), ses clés n’existent que sur votre iPhone : une seconde méthode encore accessible compte donc.

Si Braintree refuse votre code

L’aide de Braintree ne traite pas des codes d’app refusés. Vérifiez l’horloge de votre iPhone : Réglages › Général › Date et heure › Réglage automatique. Novaz vous avertit lorsque l’horloge est décalée de 15 secondes ou plus. Les autres causes sont dans Le code d’authentification ne fonctionne pas ?

Changer de téléphone

Depuis septembre 2023, vous ne pouvez plus désactiver vous-même la 2FA. À la place, My User propose une option Reset 2FA (réinitialiser la 2FA) pour le cas où vous changez de numéro de téléphone ou d’application d’authentification (Braintree) :

1. Ouvrez My User depuis votre icône d’utilisateur et faites défiler jusqu’à Two-Factor Authentication.
2. Sélectionnez Reset 2FA, saisissez votre mot de passe et suivez les étapes pour scanner un nouveau code QR.

Braintree prévient que si vous confirmez la réinitialisation sans aller jusqu’au bout, vous devrez configurer à nouveau la 2FA depuis My User ou à votre prochaine connexion. Faites-le tant que vous avez encore l’ancien téléphone. Avec une sauvegarde iCloud ou un fichier de sauvegarde Novaz, vous pouvez plutôt restaurer vos comptes sur le nouvel iPhone ; sans sauvegarde, vous ajouterez Braintree sur le nouveau à partir de zéro. Consultez Comment transférer votre application d’authentification vers un nouvel iPhone.

Si vous perdez votre application d’authentification

Essayez d’abord Text a code instead. Si cela ne fonctionne pas non plus, demandez à un Account Admin (administrateur du compte) de votre compte Braintree de désactiver la 2FA pour vous : sous l’icône en forme d’engrenage, Team (équipe), votre utilisateur, puis Disable (désactiver) dans la section Two Factor Authentication. Seuls les utilisateurs ayant le rôle Account Admin peuvent le faire. Il vous sera demandé de configurer à nouveau la 2FA à votre prochaine connexion (Braintree).

Si aucun administrateur ne peut vous aider, ou si vous êtes le seul administrateur, Braintree indique de contacter son équipe d’assistance via le formulaire de demande Get Help (obtenir de l’aide) (Braintree). Braintree ne précise ni les justificatifs demandés, ni le délai. Pour les étapes générales, consultez Vous avez perdu le téléphone qui contient votre application d’authentification ?

Aide officielle de Braintree

• Two-Factor Authentication (authentification à deux facteurs)
• Managing Users and Roles (gérer les utilisateurs et les rôles)
• Log In with PayPal (se connecter avec PayPal)
• Control Panel Overview (présentation du Control Panel)
• Get Help (obtenir de l’aide)