Sales > Payment Methods > Braintree

IMPORTANT
Migration vers Commerce 2.4 :

Pour les versions d’Adobe Commerce et de Magento Open Source antérieures à la version 2.4.0, il a été recommandé aux commerçants d’installer et de configurer l’extension officielle d’intégration des paiements de Braintree à partir du Commerce Marketplace pour remplacer l’intégration principale. Depuis la version 2.4.0, l’extension est désormais incluse dans la version principale.



Lors de la migration vers Commerce 2.4, les marchands doivent désinstaller l’extension distribuée sur le Marketplace (paypal/module-braintree ou gene/module-braintree) et mettre à jour toutes les personnalisations de code afin d’utiliser l’espace de noms PayPal_Braintree au lieu de Magento_Braintree. Les paramètres de configuration de l’extension groupée pour Commerce et de l’extension distribuée sur le Commerce Marketplace sont conservés. Les paiements placés avec ces versions de l’extension sont capturés, annulés ou remboursés normalement.



Si vous effectuez une mise à niveau vers Commerce 2.4.0 et que vous n’utilisez pas l’extension de Commerce Marketplace recommandée dans votre version 2.3.x précédente, la fonctionnalité à plusieurs adresses ne fonctionne pas avec la version 2.4.0 de Braintree. Lorsqu'un acheteur sélectionne diffuser sur plusieurs adresses , le mode de paiement du Braintree n'apparaît pas. L’extension de Commerce Marketplace précédemment recommandée pour la version 2.3.x présente ce problème d’adresse multiple.

Pour accéder aux paramètres de configuration du magasin, choisissez Stores > Settings>Configuration ​dans la barre latérale_ Admin _.

Basic Braintree Settings

Paramètres de base du Braintree

Champ
Portée
Description
Title
Affichage en magasin
Valeur par défaut : Credit Card (Braintree)
Environment
Affichage en magasin
Options : Sandbox / Production
Payment Action
Affichage en magasin
Détermine l’action effectuée par le Braintree lors du traitement d’un paiement. Options :
Authorize- Les fonds figurant sur la carte de crédit du client sont autorisés, mais pas transférés du compte. Une commande est créée dans votre administrateur de magasin. Vous pourrez ensuite capturer la vente et créer une facture.
Intent Sale (précédemment Authorize and Capture dans les versions antérieures) - Les fonds sur la carte de crédit du client sont autorisés et capturés par le Braintree, et une commande et une facture sont créées dans votre administrateur de magasin.
Sandbox Merchant ID
Affichage en magasin
Il s’agit de l’identifiant unique de votre compte de passerelle sandbox entier. Également appelé ID public ou ID de production, votre ID commercial est différent pour vos passerelles de production et d’environnement de test. Ce champ s’affiche lorsque le champ Environment ​est défini sur Sandbox.
Sandbox Public Key
Affichage en magasin
Il s’agit de votre identifiant public spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à votre passerelle de Braintree Sandbox possède sa propre clé publique sandbox. Ce champ s’affiche lorsque le champ Environment ​est défini sur Sandbox.
Sandbox Private Key
Affichage en magasin
Il s’agit de votre identifiant privé spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à votre passerelle de Braintree Sandbox possède sa propre clé privée pour l’environnement de test. Ce champ s’affiche lorsque le champ Environment ​est défini sur Sandbox.
Merchant ID
Affichage en magasin
Il s’agit de l’identifiant unique de votre compte de passerelle entier, y compris les plusieurs comptes marchands qui peuvent se trouver dans votre passerelle. Également appelé ID public ou ID de production, votre ID commercial est différent pour vos passerelles de production et d’environnement de test. Ce champ s’affiche lorsque le champ Environment ​est défini sur Production.
Public Key
Affichage en magasin
Il s’agit de votre identifiant public spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à votre passerelle de Braintree possède sa propre clé publique. Ce champ s’affiche lorsque le champ Environment ​est défini sur Production.
Private Key
Affichage en magasin
Il s’agit de votre identifiant privé spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à votre passerelle de Braintree possède sa propre clé privée. Ce champ s’affiche lorsque le champ Environment ​est défini sur Production.
Enable Card Payments
Site Web
Détermine si le mode de paiement par carte de crédit du Braintree est disponible pour vos clients comme mode de paiement. Options : Yes / No
Enable Vault for Card Payments
Site Web
Lorsqu’elle est activée, cette option permet un stockage sécurisé des informations de paiement des clients, de sorte que les clients n’aient pas à saisir à nouveau leurs informations de carte de crédit pour chaque achat. Options : Yes / No
Enable Vault CVV Reverification
Site Web
Lorsque cette option est activée, la validation est effectuée pour la configuration des règles CVV dans votre compte de Braintree. Options : Yes / No

Advanced Braintree Settings

Paramètres avancés du Braintree

Champ
Portée
Description
Vault Title
Site Web
Titre descriptif de votre référence qui identifie le coffre dans lequel les informations de votre carte client sont stockées.
Merchant Account ID
Site Web
Identifiant du compte marchand à associer aux transactions Braintree de ce site web. Si rien n’est indiqué, le compte marchand par défaut de votre compte Braintree est utilisé.
Enable Checkout Express Payments
Site Web
Offre une expérience de passage en caisse plus rapide avec les options de paiement express au début du processus de passage en caisse, notamment PayPal, PayLater, Apple Pay et Google Pay. Options : Yes / No
Skip Fraud Checks on Admin Orders
Site Web
Empêche l’envoi de la transaction pour évaluation dans le cadre de Advanced Fraud Tools contrôles, sur les commandes passées par l’administrateur uniquement lorsqu’elle est définie sur Yes.
Options : Yes / No
Bypass Fraud Protection Threshold
Site Web
Advanced Fraud Protection les contrôles sont contournés lorsque la valeur de seuil est atteinte ou dépassée. Si vous laissez ce champ vide, cette option est désactivée.
Debug
Site Web
Détermine si les communications entre le système du Braintree et votre magasin sont enregistrées dans un fichier journal. Options : Yes / No
CVV Verification
Site Web
Détermine si les clients sont tenus de fournir le code de sécurité à trois chiffres à partir de l’arrière d’une carte de crédit. Options : Yes / No
Send Card Line Items
Site Web
Envoyez les articles du panier pour tous les modes de paiement. Options : Yes / No
Credit Card Types
Site Web
Indique chaque carte de crédit que vous acceptez comme paiement par le biais de Braintree. Appuyez sur Ctrl (ou Command sur Mac) et maintenez-le enfoncé pour sélectionner une combinaison de cartes. Options : American Express / Visa / MasterCard / Discover / JCB / Diners / Maestro International
Sort Order
Site Web
Détermine l’ordre dans lequel Braintree est répertorié avec d’autres méthodes de paiement lors de l’extraction.

Braintree Webhooks Settings

Paramètres des webhooks Braintree

Champ
Portée
Description
Enable Webhook
Site Web
Pour activer la fonctionnalité webhook pour la protection contre la fraude, les paiements ACH, les méthodes de paiement locales et les litiges. Options : Yes / No
Fraud Protection URL
Site Web
Ajoutez cette URL dans votre compte de Braintree en tant que Webhook Destination URL. Cette URL doit être sécurisée et publiquement accessible.
Fraud Protection Approve Order Status
Site Web
Lorsque la protection contre la fraude est approuvée par Braintree, l’état de la commande sélectionnée est affecté à la commande Commerce. Cet état est utilisé pour mettre à jour l’état de la commande dans laquelle le mode de paiement ACH est utilisé et lorsqu’il passe à SETTLED en Braintree.
Fraud Protection Reject Order Status
Site Web
Lorsque la protection contre la fraude est rejetée par le Braintree, l’état de la commande sélectionnée est affecté à la commande Commerce. Cet état est utilisé pour mettre à jour l’état de la commande dans laquelle le mode de paiement ACH est utilisé et lorsque SETTLEMENT est DECLINED en Braintree.

Country Specific Settings

Paramètres spécifiques à un pays

Champ
Portée
Description
Payment from Applicable Countries
Site Web
Détermine si vous acceptez les paiements traités par le Braintree de tous les pays ou uniquement de certains pays. Options : All Allowed Countries / Specific Countries
Payment from Specific Countries
Site Web
Le cas échéant, identifie les pays spécifiques à partir desquels vous acceptez les paiements traités par le Braintree.
Country Specific Credit Card Types
Site Web
Identifie les cartes de crédit acceptées par pays pour les paiements traités par Braintree. Un enregistrement est enregistré pour chaque pays. Options :
Country- Choisissez le pays.
Allowed Card Types - Sélectionnez chaque carte de crédit acceptée du pays comme paiement par le Braintree.
Add- Ajoutez une ligne pour autoriser les cartes de crédit pour un autre pays.
Action - Supprime l’enregistrement des cartes de crédit autorisées pour le pays.

ACH through Braintree

ACH par Braintree

Champ
Portée
Description
Enabled ACH Direct Debit
Site Web
Détermine si ACH Direct Debit est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No
Enable Vault for ACH Direct Debit
Site Web
Les clients peuvent activer/stocker leur méthode de paiement en direct ACH à usage unique pour une utilisation ultérieure. Une fois les détails du paiement validés, le client peut utiliser le mode de paiement ACH Direct Debit sans saisir à nouveau les données ou sans réauthentifier ses informations de paiement. Options : Yes / No
Sort Order
Site Web
Détermine la commande qui ACH Direct Debit est répertoriée avec d’autres méthodes de paiement lors de l’extraction.

Apple Pay through Braintree

Apple Pay through Braintree

Champ
Portée
Description
Enable ApplePay through Braintree
Site Web
Détermine si le paiement Apple est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No

Le domaine doit être vérifié dans le compte Braintree en premier.
Enable Vault for ApplePay
Site Web
Les clients peuvent Vault/stocker leur méthode de paiement payant Apple pour une utilisation ultérieure. Une fois les détails du paiement validés, le client peut utiliser l’option Payer Apple sans saisir de nouveau les données ou ne pas réauthentifier ses informations de paiement. Options : Yes / No
Payment Action
Site Web
Détermine l’action effectuée par le Braintree lors du traitement d’un paiement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais pas transférés depuis le compte du client. Une commande est créée dans votre administrateur de magasin. Vous pourrez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et capturés par le Braintree, et une commande et une facture sont créées dans votre administrateur de magasin. Remarque : Il s’agissait de Authorize and Capture dans les versions 2.3.x et antérieures.
Merchant Name
Affichage en magasin
Libellé affiché pour les clients dans la fenêtre contextuelle ApplePay.
Sort Order
Site Web
Détermine la commande pour laquelle le paiement Apple est répertorié avec d’autres méthodes de paiement lors du passage en caisse.

Local Payment Methods

Méthodes de paiement locales

Champ
Portée
Description
Enabled Local Payment Methods
Site Web
Détermine si le mode de paiement local est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No
Title
Site Web
Libellé qui s’affiche dans la section Mode de paiement du passage en caisse . Valeur par défaut : Local Payments
Fallback Button Text
Site Web
Saisissez le texte à utiliser pour le bouton qui apparaît sur la page du Braintree de secours qui ramène les clients vers le site web. Valeur par défaut : Complete Checkout
Redirect on Fail
Site Web
Indique l’URL vers laquelle les clients doivent être redirigés lorsque les transactions du mode de paiement local sont annulées, échouées ou en cas d’erreur. Il doit s’agir de la page de paiement du passage en caisse (par exemple, https://www.domain.com/checkout#payment).
Allowed Payment Method
Site Web
Sélectionnez le mode de paiement local à activer. Options : Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (pas encore pris en charge)
Sort Order
Site Web
Détermine la commande selon laquelle le mode de paiement local est répertorié avec d’autres méthodes de paiement lors de l’extraction.
NOTE
L’extension de Braintree groupé ne prend pas en charge tous les modes de paiement locaux répertoriés dans la documentation du développeur de Braintree. D'autres modes de paiement locaux sont en cours de développement et seront pris en charge dans les prochaines versions.

GooglePay through Braintree

GooglePay par l’intermédiaire du Braintree

Champ
Portée
Description
Enabled GooglePay through Braintree
Site Web
Détermine si le paiement Google Pay est inclus comme mode de paiement via Braintree. Options : Yes / No
Enable Vault for GooglePay
Site Web
Les clients peuvent activer/stocker leur méthode de paiement payant Google pour une utilisation ultérieure. Une fois les détails du paiement validés, le client peut utiliser l’option Payer Google sans saisir à nouveau les données ni authentifier à nouveau ses informations de paiement. Options : Yes / No
Payment Action
Site Web
Détermine l’action effectuée par le Braintree lors du traitement d’un paiement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais pas transférés depuis le compte du client. Une commande est créée dans votre administrateur de magasin. Vous pourrez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et capturés par le Braintree, et une commande et une facture sont créées dans votre administrateur de magasin. Remarque : Il s’agissait de Authorize and Capture dans les versions 2.3.x et antérieures.
Button Color
Site Web
Détermine la couleur du bouton Google Pay. Options : White / Black
Merchant ID
Affichage en magasin
L’identifiant fourni par Google doit être renseigné ici.
Accepted Cards
Site Web
Sélectionnez le type de cartes qu’un client peut utiliser pour passer commande à l’aide de Google Pay.
Sort Order
Site Web
Détermine la commande que Google Pay est répertoriée avec d’autres méthodes de paiement lors du passage en caisse.

Venmo through Braintree

Venmo par Braintree

Champ
Portée
Description
Enable Venmo through Braintree
Site Web
Détermine si Venmo est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No
Enable Vault for Venmo
Site Web
Les clients peuvent Vault/stocker leur méthode de paiement Venmo pour une utilisation ultérieure. Une fois les détails du paiement validés, le client peut utiliser le mode de paiement Venmo sans saisir à nouveau les données ou réauthentifier ses informations de paiement. Options : Yes / No
Payment Action
Site Web
Détermine l’action effectuée par le Braintree lors du traitement d’un paiement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais pas transférés depuis le compte du client. Une commande est créée dans votre administrateur de magasin. Vous pourrez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et capturés par le Braintree, et une commande et une facture sont créées dans votre administrateur de magasin. Remarque : Il s’agissait de Autoriser et capturer dans les versions 2.3.x et antérieures.
Sort Order
Site Web
Détermine la commande que Venmo est répertorié avec d’autres méthodes de paiement lors du passage en caisse.

PayPal through Braintree

PayPal via Braintree

Champ
Portée
Description
Enable PayPal through Braintree
Site Web
Détermine si PayPal est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No
Enable PayPal Credit through Braintree
Site Web
Détermine si le crédit PayPal est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No. Ce champ est visible lorsque Enable PayPal through Braintree est défini sur Yes
Enable PayPal PayLater through Braintree
Site Web
Détermine si PayPal PayLater est inclus comme mode de paiement par le biais de Braintree. Options : Yes / No. Ce champ est visible lorsque Enable PayPal through Braintree est défini sur Yes
Title
Affichage en magasin
Libellé qui identifie PayPal par l’intermédiaire du Braintree aux clients lors du passage en caisse. Valeur par défaut : PayPal
Vault Enabled
Site Web
Lorsqu’elle est activée, permet d’assurer un stockage sécurisé des informations de paiement des clients, de sorte que les clients n’aient pas à entrer à nouveau leurs informations PayPal pour chaque achat. Options : Yes / No
Send Cart Line Items for PayPal
Site Web
Envoyez les éléments de ligne (articles de commande) à PayPal, ainsi que les cartes-cadeaux, l’encapsulage des cadeaux pour les articles, l’encapsulage des cadeaux pour la commande, le crédit de magasin, la livraison et les taxes comme éléments de ligne. Options : Yes / No
Sort Order
Site Web
Numéro qui détermine l’ordre dans lequel PayPal par l’intermédiaire du Braintree est répertorié avec d’autres méthodes de paiement lors du passage en caisse.
Override Merchant Name
Affichage en magasin
Nom alternatif pouvant être utilisé pour identifier le marchand pour chaque vue de magasin.
Payment Action
Site Web
Détermine l’action effectuée par PayPal via Braintree lors du traitement d’un paiement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais pas transférés depuis le compte du client. Une commande est créée dans votre administrateur de magasin. Vous pourrez ensuite capturer la vente et créer une facture.
Authorize and Capture - Les fonds sur la carte du client sont autorisés et capturés par PayPal via Braintree, et une commande et une facture sont créées dans votre administrateur de magasin.
Payment from Applicable Countries
Site Web
Détermine si vous acceptez des paiements traités par PayPal par l’intermédiaire de Braintree provenant de tous les pays ou uniquement de pays spécifiques. Options : All Allowed Countries / Specific Countries
Payment from Specific Countries
Site Web
Le cas échéant, identifie les pays spécifiques à partir desquels vous acceptez les paiements traités par le Braintree.
Require Customer’s Billing Address
Site Web
Détermine si l’adresse de facturation du client est requise pour envoyer une commande. Options : Yes / No
Debug
Site Web
Détermine si les communications entre PayPal via le système de Braintree et votre boutique sont enregistrées dans un fichier journal. Options : Yes / No
Display on Shopping Cart
Site Web
Détermine si le bouton PayPal apparaît dans le mini panier et sur la page panier. Options : Yes / No
NOTE
PayPal Credit ou PayPal PayLater peuvent être activés. Les deux méthodes ne peuvent pas être activées de la même manière.

Styling

Style PayPal

Champ
Portée
Description
Location
Site Web
Détermine où les boutons et messages PayPal sont rendus sur le storefront. Options : Mini-Cart and Cart Page / Checkout Page / Product Page

Mini-Cart and Cart Page

L’option et les paramètres de cette section varient en fonction du paramètre défini dans le champ Location.

Champ
Portée
Description
PayPal Button Type
Site Web
Définit le bouton sur l’un des trois types suivants : PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

Les options et paramètres de cette section varient en fonction du type de bouton sélectionné dans le champ PayPal Button Type.

Champ
Portée
Description
Show PayPal Button
Site Web
Détermine l’emplacement du bouton PayPal sur l’emplacement sélectionné. Options : Yes / No
Button Label
Site Web
Détermine le libellé du bouton PayPal. Options : Paypal / Checkout / Buy Now / Pay
Color
Site Web
Détermine la couleur du bouton PayPal. Options : Blue / Black / Gold / Silver
Shape
Site Web
Détermine la forme du bouton PayPal. Options : Pill / Rectangle
Size(Deprecated)
Site Web
Détermine la taille du bouton PayPal. Options : Medium / Large / Responsive
NOTE
Le champ de configuration Size(Deprecated) est obsolète et n’est pas utilisé pour appliquer un style aux boutons PayPal.

PayLater Messaging

Champ
Portée
Description
Show PayLater Messaging
Site Web
Active la messagerie PayLater à l’emplacement sélectionné. Options : Yes / No. Lorsqu’elle est activée, elle affiche la messagerie PayLater pour les offres disponibles (des restrictions s’appliquent).
Message Layout
Site Web
Détermine la disposition du message PayLater. Options : Text / Flex
Logo
Site Web
Détermine le type de logo utilisé pour le bouton PayPal. Options : Inline / Primary / Alternative / None
Logo Position
Site Web
Détermine la position du logo pour le bouton PayPal. Options : Left / Right / Top
Text Color
Site Web
Détermine la couleur du texte du bouton PayPal. Options : Black / White / Monochrome / Grayscale

Lorsque ces options sont définies, vous pouvez voir l’aperçu des boutons PayPal et des messages PayLater. Vous pouvez utiliser des commandes pour appliquer les paramètres ou réinitialiser les valeurs :

Champ
Portée
Description
Apply
Site Web
Stocke les paramètres de style sélectionnés pour les boutons et la messagerie PayLater et les applique à l’emplacement actuel et au type de bouton actuel.
Apply to All Buttons
Site Web
Stocke les paramètres de style sélectionnés pour les boutons et les valeurs de messagerie PayLater et les applique à tous les types de boutons et emplacements.
Reset to Recommended Defaults
Site Web
Renvoie les paramètres de style aux valeurs par défaut recommandées pour les boutons et la messagerie PayLater et les applique à tous les types et emplacements de boutons.

Paramètres de vérification sécurisée 3d

Paramètres de vérification sécurisée 3D

Champ
Portée
Description
3D Secure Verification
Site Web
Détermine si une transaction doit passer un processus de vérification supplémentaire lorsque le client est inscrit dans un programme tel que Vérifié par VISA. Options : Yes / No
Always request 3DS
Site Web
Envoyez toujours une requête sécurisée 3D pour toutes les transactions. Options : Yes / No
Threshold Amount
Site Web
Détermine le montant maximal de commande autorisé pour le traitement sur une seule commande. Braintree refuse l’autorisation si le montant de la commande dépasse ce seuil.
Verify for Applicable Countries
Site Web
Détermine les pays dans lesquels le paiement doit être vérifié. Options : All Allowed Countries / Specific Countries
Verify for Specific Countries
Site Web
Le cas échéant, identifie les pays spécifiques à partir desquels le paiement par Braintree doit être vérifié.

Dynamic Descriptors

Descripteurs dynamiques

Champ
Portée
Description
Name
Affichage en magasin
Le descripteur de nom comporte deux parties, séparées par un astérisque (*). La première partie du descripteur identifie la société ou l’application de données côté serveur et la seconde partie identifie le produit. Par exemple : company*myproduct

La longueur des parties Société et Produit du descripteur peut être attribuée de la manière suivante, pour une longueur combinée de 22 caractères :
Option 1- La société doit comporter trois caractères / Le produit peut comporter jusqu’à 18 caractères
Option 2 - La société doit comporter sept caractères / Le produit peut comporter jusqu’à 14 caractères
Option 3- La société doit comporter 12 caractères / Le produit peut comporter neuf
Phone
Affichage en magasin
Le descripteur de téléphone doit comporter de dix à 14 caractères et ne peut contenir que des nombres, des tirets, des parenthèses et des points. Par exemple : 9999999999 (999) 999-9999 999.999.9999
URL
Affichage en magasin
Le descripteur d’URL représente votre nom de domaine et peut contenir jusqu’à 13 caractères. Par exemple : company.com
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672