Sales > Payment Methods > Braintree

IMPORTANT
Migration de 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 d’intégration de paiement par Braintree officielle à 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 commerçants doivent désinstaller l’extension distribuée sur la Marketplace (paypal/module-braintree ou gene/module-braintree) et mettez à jour toutes les personnalisations de code pour utiliser PayPal_Braintree espace de noms 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 fonction à adresses multiples ne fonctionne pas avec la version 2.4.0 de Braintree. Lorsqu’un acheteur sélectionne diffuser à plusieurs adresses , le mode de paiement du Braintree n’apparaît pas. L’extension de Commerce Marketplace précédemment recommandée pour 2.3.x présente ce problème d’adresses multiples.

Pour accéder aux paramètres de configuration du magasin, choisissez Stores > Settings>Configuration ​à partir du_ Admin _barre latérale.

Basic Braintree Settings

Paramètres de base du Braintree

Champ
Portée
Description
Title
Affichage de la boutique
Valeur par défaut : Credit Card (Braintree)
Environment
Affichage de la boutique
Options : Sandbox / Production
Payment Action
Affichage de la boutique
Détermine l'action entreprise par le Braintree lors du traitement d'un règlement. Options :
Authorize- Les fonds figurant sur la carte de crédit du client sont autorisés, mais ne sont pas transférés du compte. Une commande est créée dans l’administrateur de votre boutique. Vous pouvez ensuite capturer la vente et créer une facture.
Intent Sale (précédemment Authorize and Capture dans les versions antérieures) - Les fonds figurant sur la carte de crédit du client sont autorisés et saisis par Braintree. Une commande et une facture sont créées dans l’administration de votre boutique.
Sandbox Merchant ID
Affichage de la boutique
Il s’agit de l’identifiant unique de l’ensemble de votre compte de passerelle Sandbox. Également appelé ID public ou ID de production, votre ID de commerçant est différent pour vos passerelles de production et sandbox. Ce champ s’affiche lorsque Environment ​le champ est défini sur Sandbox.
Sandbox Public Key
Affichage de la boutique
Il s’agit de votre identifiant public spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à la passerelle du Braintree de sandbox dispose de sa propre clé publique de sandbox. Ce champ s’affiche lorsque Environment ​le champ est défini sur Sandbox.
Sandbox Private Key
Affichage de la boutique
Il s’agit de votre identifiant privé spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à la passerelle du Braintree de sandbox dispose de sa propre clé privée pour le sandbox. Ce champ s’affiche lorsque Environment ​le champ est défini sur Sandbox.
Merchant ID
Affichage de la boutique
Il s’agit de l’identifiant unique de l’ensemble de votre compte de passerelle, y compris les différents comptes commerçants qui peuvent se trouver dans votre passerelle. Également appelé ID public ou ID de production, votre ID de commerçant est différent pour vos passerelles de production et sandbox. Ce champ s’affiche lorsque Environment ​le champ est défini sur Production.
Public Key
Affichage de la boutique
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 dispose de sa propre clé publique. Ce champ s’affiche lorsque Environment ​le champ est défini sur Production.
Private Key
Affichage de la boutique
Il s’agit de votre identifiant privé spécifique à l’utilisateur qui limite l’accès aux données chiffrées. Chaque utilisateur associé à la passerelle de votre Braintree dispose de sa propre clé privée. Ce champ s’affiche lorsque Environment ​le champ est défini sur Production.
Enable Card Payments
Site internet
Détermine si le mode de paiement par carte de crédit du Braintree est disponible pour vos clients en tant que mode de paiement. Options : Yes / No
Enable Vault for Card Payments
Site internet
Lorsqu’il est activé, fournit un stockage sécurisé pour les informations de paiement du client, 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 internet
Une fois 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 {width="550" modal="regular"}

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

Braintree Webhooks Settings

Paramètres des Webhooks du Braintree

Champ
Portée
Description
Enable Webhook
Site internet
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 internet
Ajoutez cette URL à votre compte de Braintree en tant que Webhook Destination URL. Cette URL doit être sécurisée et accessible au public.
Fraud Protection Approve Order Status
Site internet
Lorsque la protection contre la fraude est approuvée par Braintree, le statut de la commande sélectionnée est attribué à la commande Commerce. Ce statut est utilisé pour mettre à jour le statut de la commande où le mode de paiement ACH est utilisé et quand il passe à SETTLED en Braintree.
Fraud Protection Reject Order Status
Site internet
Lorsque la protection contre la fraude est rejetée par Braintree, le statut de la commande sélectionnée est attribué à la commande Commerce. Ce statut est utilisé pour mettre à jour le statut de la commande où le mode de paiement ACH est utilisé et quand SETTLEMENT est DECLINED en Braintree.

Country Specific Settings

Paramètres spécifiques au pays

Champ
Portée
Description
Payment from Applicable Countries
Site internet
Détermine si vous acceptez les paiements traités par Braintree de tous les pays ou uniquement de pays spécifiques. Options : All Allowed Countries / Specific Countries
Payment from Specific Countries
Site internet
Le cas échéant, indique les pays spécifiques à partir desquels vous acceptez les paiements traités par Braintree.
Country Specific Credit Card Types
Site internet
Indique 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 depuis le pays pour le paiement par 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 via Braintree

Champ
Portée
Description
Enabled ACH Direct Debit
Site internet
Détermine si ACH Direct Debit est inclus comme mode de paiement par Braintree. Options : Yes / No
Enable Vault for ACH Direct Debit
Site internet
Les clients peuvent mettre en chambre forte ou stocker leur méthode de paiement ACH Direct Debit à usage unique pour une utilisation ultérieure. Une fois les détails de paiement enregistrés, le client peut utiliser la méthode de paiement ACH Direct Debit sans saisir à nouveau les données ni authentifier à nouveau ses informations de paiement. Options : Yes / No
Sort Order
Site internet
Détermine l’ordre dans lequel ACH Direct Debit est répertorié avec d’autres modes de paiement lors du passage en caisse.

Apple Pay through Braintree

Apple Pay through Braintree

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

Le domaine doit être d’abord vérifié dans le compte Braintree..
Enable Vault for ApplePay
Site internet
Les clients peuvent mettre en coffre/stocker leur mode de paiement Apple Pay pour une utilisation ultérieure. Une fois les informations de paiement enregistrées, le client peut utiliser Apple Pay sans saisir à nouveau les données ni authentifier à nouveau ses informations de paiement. Options : Yes / No
Payment Action
Site internet
Détermine l'action entreprise par le Braintree lors du traitement d'un règlement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais ne sont pas transférés depuis le compte du client. Une commande est créée dans l’administrateur de votre boutique. Vous pouvez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et saisis par Braintree, et une commande et une facture sont créées dans votre administrateur de boutique. Remarque : C'était Authorize and Capture dans la version 2.3.x et les versions antérieures.
Merchant Name
Affichage de la boutique
Libellé affiché pour les clients dans la fenêtre contextuelle ApplePay.
Sort Order
Site internet
Détermine l'ordre dans lequel Apple Pay est répertorié avec d'autres modes de paiement lors du passage en caisse.

Local Payment Methods

Modes de paiement locaux

Champ
Portée
Description
Enabled Local Payment Methods
Site internet
Détermine si le mode de paiement local est inclus comme mode de paiement par Braintree. Options : Yes / No
Title
Site internet
Libellé qui apparaît dans la section Mode de paiement de la commande. Valeur par défaut : Local Payments
Fallback Button Text
Site internet
Saisissez le texte à utiliser pour le bouton qui s’affiche sur la page du Braintree de secours qui renvoie les clients au site web. Valeur par défaut : Complete Checkout
Redirect on Fail
Site internet
Spécifie l'URL où les clients doivent être redirigés lorsque des transactions de mode de paiement local sont annulées, échouent ou rencontrent des erreurs. Il doit s’agir de la page de paiement de la commande (par exemple, https://www.domain.com/checkout#payment).
Allowed Payment Method
Site internet
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 internet
Détermine l'ordre dans lequel le mode de paiement local est répertorié avec d'autres modes de paiement lors du passage en caisse.
NOTE
L’extension de Braintree groupé ne prend pas en charge tous les modes de paiement locaux répertoriés dans le Documentation destinée aux développeurs de Braintree. D’autres méthodes de paiement locales sont en cours de développement et seront prises en charge dans les prochaines versions.

GooglePay through Braintree

GooglePay via Braintree

Champ
Portée
Description
Enabled GooglePay through Braintree
Site internet
Détermine si Google Pay le paiement est inclus comme mode de paiement par Braintree. Options : Yes / No
Enable Vault for GooglePay
Site internet
Les clients peuvent mettre en coffre/stocker leur mode de paiement Google Pay pour une utilisation ultérieure. Une fois les informations de paiement enregistrées, le client peut utiliser Google Pay sans saisir à nouveau les données ni authentifier à nouveau ses informations de paiement. Options : Yes / No
Payment Action
Site internet
Détermine l'action entreprise par le Braintree lors du traitement d'un règlement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais ne sont pas transférés depuis le compte du client. Une commande est créée dans l’administrateur de votre boutique. Vous pouvez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et saisis par Braintree, et une commande et une facture sont créées dans votre administrateur de boutique. Remarque : C'était Authorize and Capture dans la version 2.3.x et les versions antérieures.
Button Color
Site internet
Détermine la couleur de l’image Google Pay Bouton. Options : White / Black
Merchant ID
Affichage de la boutique
L’ID fourni par Google doit être saisi ici.
Accepted Cards
Site internet
Sélectionnez le type de cartes qu’un client peut utiliser pour passer une commande Google Pay.
Sort Order
Site internet
Détermine l'ordre dans lequel Google Pay est répertorié avec d'autres modes de paiement lors du passage en caisse.

Venmo through Braintree

Venmo via Braintree

Champ
Portée
Description
Enable Venmo through Braintree
Site internet
Détermine si Venmo est inclus comme mode de paiement par Braintree. Options : Yes / No
Enable Vault for Venmo
Site internet
Les clients peuvent mettre en coffre/stocker leur méthode de paiement Venmo pour une utilisation ultérieure. Une fois les détails de paiement enregistrés, le client peut utiliser la méthode de paiement Venmo sans saisir à nouveau les données ni authentifier à nouveau ses informations de paiement. Options : Yes / No
Payment Action
Site internet
Détermine l'action entreprise par le Braintree lors du traitement d'un règlement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais ne sont pas transférés depuis le compte du client. Une commande est créée dans l’administrateur de votre boutique. Vous pouvez ensuite capturer la vente et créer une facture.
Intent Sale - Les fonds sur la carte du client sont autorisés et saisis par Braintree, et une commande et une facture sont créées dans votre administrateur de boutique. Remarque : C'était Autoriser et capturer dans la version 2.3.x et les versions antérieures.
Sort Order
Site internet
Détermine l'ordre dans lequel Venmo est listé avec d'autres modes de paiement lors du passage en caisse.

PayPal through Braintree

PayPal par Braintree {width="550" modal="regular"}

Champ
Portée
Description
Enable PayPal through Braintree
Site internet
Détermine si PayPal est inclus comme mode de paiement par Braintree. Options : Yes / No
Enable PayPal Credit through Braintree
Site internet
Détermine si le crédit PayPal est inclus comme mode de paiement par Braintree. Options : Yes / No. Ce champ devient visible lorsque Enable PayPal through Braintree est défini sur Yes
Enable PayPal PayLater through Braintree
Site internet
Détermine si PayPal PayLater est inclus comme mode de paiement par Braintree. Options : Yes / No. Ce champ devient visible lorsque Enable PayPal through Braintree est défini sur Yes
Title
Affichage de la boutique
Libellé qui identifie PayPal par Braintree pour les clients lors du passage en caisse. Valeur par défaut : PayPal
Vault Enabled
Site internet
Lorsqu'il est activé, fournit un stockage sécurisé pour les informations de paiement du client, de sorte que les clients n'ont pas à saisir leurs informations PayPal pour chaque achat. Options : Yes / No
Send Cart Line Items for PayPal
Site internet
Envoyez les articles de ligne (articles de commande) à PayPal avec les cartes-cadeaux, l'emballage-cadeau pour les articles, l'emballage-cadeau pour la commande, le crédit de magasin, l'expédition et la taxe en tant qu'articles de ligne. Options : Yes / No
Sort Order
Site internet
Un numéro qui détermine l'ordre dans lequel PayPal par Braintree est répertorié avec d'autres méthodes de paiement lors du passage en caisse.
Override Merchant Name
Affichage de la boutique
Autre nom pouvant être utilisé pour identifier le commerçant pour chaque vue de magasin.
Payment Action
Site internet
Détermine l'action entreprise par PayPal par Braintree lors du traitement d'un paiement. Options :
Authorize- Les fonds sur la carte du client sont autorisés, mais ne sont pas transférés depuis le compte du client. Une commande est créée dans l’administrateur de votre boutique. Vous pouvez ensuite capturer la vente et créer une facture.
Authorize and Capture - Les fonds sur la carte du client sont autorisés et saisis par PayPal par Braintree, et une commande et une facture sont créées dans votre administrateur de boutique.
Payment from Applicable Countries
Site internet
Détermine si vous acceptez les paiements traités par PayPal par Braintree provenant de tous les pays ou uniquement de certains pays. Options : All Allowed Countries / Specific Countries
Payment from Specific Countries
Site internet
Le cas échéant, indique les pays spécifiques à partir desquels vous acceptez les paiements traités par Braintree.
Require Customer’s Billing Address
Site internet
Détermine si l'adresse de facturation du client est requise pour envoyer une commande. Options : Yes / No
Debug
Site internet
Détermine si les communications entre PayPal par le biais du système de Braintree et votre boutique sont enregistrées dans un fichier journal. Options : Yes / No
Display on Shopping Cart
Site internet
Détermine si le bouton PayPal apparaît dans le mini chariot et sur le panier page. Options : Yes / No
NOTE
Soit PayPal Credit ou PayPal PayLater peut être activé. Les deux méthodes ne peuvent pas être activées simultanément.

Styling

Styles PayPal

Champ
Portée
Description
Location
Site internet
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 dans le Location ​champ .

Champ
Portée
Description
PayPal Button Type
Site internet
Définit le bouton sur l’un des trois types : 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 PayPal Button Type ​champ .

Champ
Portée
Description
Show PayPal Button
Site internet
Détermine l'emplacement du bouton PayPal sur l'emplacement sélectionné. Options : Yes / No
Button Label
Site internet
Détermine le libellé du bouton PayPal. Options : Paypal / Checkout / Buy Now / Pay
Color
Site internet
Détermine la couleur du bouton PayPal. Options : Blue / Black / Gold / Silver
Shape
Site internet
Détermine la forme du bouton PayPal. Options : Pill / Rectangle
Size(Deprecated)
Site internet
Détermine la taille du bouton PayPal. Options : Medium / Large / Responsive
NOTE
Le Size(Deprecated) Le champ de configuration 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 internet
Active la messagerie PayLater à l'emplacement sélectionné. Options : Yes / No. Lorsqu’elle est activée, elle affiche un message PayLater pour les offres disponibles (restrictions s’appliquent).
Message Layout
Site internet
Détermine la disposition du message PayLater. Options : Text / Flex
Logo
Site internet
Détermine le type de logo utilisé pour le bouton PayPal. Options : Inline / Primary / Alternative / None
Logo Position
Site internet
Détermine la position du logo pour le bouton PayPal. Options : Left / Right / Top
Text Color
Site internet
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 certaines commandes pour appliquer les paramètres ou réinitialiser les valeurs :

Champ
Portée
Description
Apply
Site internet
Stocke les paramètres de style sélectionnés pour les boutons et les messages PayLater et les applique à l’emplacement et au type de bouton actuels.
Apply to All Buttons
Site internet
Stocke les paramètres de style sélectionnés pour les boutons et les valeurs de message PayLater et les applique à tous les types de boutons et emplacements.
Reset to Recommended Defaults
Site internet
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 de boutons et emplacements.

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 internet
Détermine si une transaction doit passer un processus de vérification supplémentaire lorsque le client est inscrit à un programme tel que Vérifié par VISA. Options : Yes / No
Always request 3DS
Site internet
Contestez toujours la demande 3D Secure pour toutes les transactions. Options : Yes / No
Threshold Amount
Site internet
Détermine le montant de commande maximal autorisé pour le traitement d'une seule commande. Le Braintree refuse l’autorisation si le montant de la commande dépasse ce montant seuil.
Verify for Applicable Countries
Site internet
Détermine les pays où le paiement doit être vérifié. Options : All Allowed Countries / Specific Countries
Verify for Specific Countries
Site internet
Le cas échéant, indique les pays spécifiques à partir desquels le paiement par Braintree doit être vérifié.

Dynamic Descriptors

Descripteurs dynamiques

Champ
Portée
Description
Name
Affichage de la boutique
Le descripteur Nom comporte deux parties, séparées par un astérisque (*). La première partie du descripteur identifie la société ou l'administrateur de base de données et la seconde partie identifie le produit. Par exemple : company*myproduct

La longueur des parties Société et Produit du descripteur peut être allouée des manières suivantes, pour une longueur combinée maximale de 22 caractères :
Option 1- La société doit comporter trois caractères / Le produit peut contenir jusqu’à 18 caractères
Option 2 - La société doit comporter sept caractères / Le produit peut contenir jusqu’à 14 caractères
Option 3- La société doit comporter 12 caractères / Le produit peut comporter jusqu’à neuf caractères.
Phone
Affichage de la boutique
Le descripteur téléphonique doit comporter entre 10 et 14 caractères et ne peut contenir que des chiffres, des tirets, des parenthèses et des points. Par exemple : 9999999999 (999) 999-9999 999.999.9999
URL
Affichage de la boutique
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