Braintree
Braintree offre une expérience de paiement entièrement personnalisable avec la détection des fraudes et l’intégration de PayPal. Il prend en charge Apple Pay, Google Pay, ACH, Venmo et les méthodes de paiement locales. Braintree réduit la charge de conformité PCI pour les commerçants, car la transaction a lieu sur le système de Braintree. L’intégration des paiements Braintree est développée par GENE Commerce.
Étape 1 : Obtention des informations d’identification de votre Braintree
Accédez à Paiements de Braintree et inscrivez-vous à un compte.
Étape 2 : définition des paramètres de base
-
Sur la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Dans le panneau de gauche, développez Sales et choisissez Payment Methods.
-
Si votre installation Commerce comporte plusieurs sites web, magasins ou vues, dans le coin supérieur gauche, sélectionnez l’ Store View où s’applique la configuration.
-
Dans la section Merchant Location, vérifiez que Merchant Country est défini sur l’emplacement de votre entreprise.
-
-
Sous Recommended Solutions, dans la section_Braintree Payments (par GENE Commerce v4.6.1 - Notes de mise à jour_, cliquez sur Configure.
{width="600" modal="regular"}
-
Pour Title, saisissez un titre qui identifie Braintree comme option de paiement lors du passage en caisse.
-
Définissez l’opération actuelle Environment pour les transactions du Braintree sur
Sandbox
ouProduction
Lors du test de la configuration dans un environnement de test, utilisez uniquement les numéros de carte de crédit recommandés par le Braintree. Lorsque vous êtes prêt à passer en production avec Braintree, définissez Environment sur
Production
.{width="600" modal="regular"}
-
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Approuve l’achat et met un frein aux fonds. Le montant n’est pas retiré du compte bancaire du client tant que la vente n’a pas été capturée par le commerçant.|Intent Sale
- Le montant de l’achat est autorisé et immédiatement retiré du compte du client. Remarque : Cette valeur était Autoriser et capturer dans les versions 2.3.x et antérieures.|
-
Saisissez le Sandbox Merchant ID / Merchant ID de votre compte de Braintree.
-
Saisissez les informations d’identification suivantes à partir de votre compte de Braintree :
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE Il existe des champs distincts pour les environnements (Sandbox et Production) et les autres champs sont générés en fonction de l’environnement sélectionné. -
Avant d’enregistrer la configuration, cliquez sur Validate Credentials pour valider vos informations d’identification.
-
Définissez Enable Card Payments sur
Yes
.{width="600" modal="regular"}
Si vous souhaitez pouvoir stocker les informations sur les clients en toute sécurité, afin que les clients n’aient pas à les ré-entrer chaque fois qu’ils effectuent un achat, définissez Enable Vault for Card Payments sur
Yes
.
Étape 3 : définition des paramètres avancés
-
Développez la section sur Advanced Braintree Settings .
{width="550" modal="regular"}
-
Pour Vault Title, saisissez un titre descriptif pour votre référence qui identifie le coffre où sont stockées les informations de votre carte client.
-
Saisissez le Merchant Account ID de votre compte de Braintree.
Si vous ne spécifiez pas le compte marchand à utiliser, Braintree traite la transaction à l’aide de votre compte marchand par défaut.
-
Pour offrir une expérience de passage en caisse plus rapide avec les options de paiement express au début du processus de passage en caisse, y compris PayPal, PayLater, Apple Pay et Google Pay, définissez Enable Checkout Express Payments sur
Yes
. -
Si vous souhaitez empêcher l’envoi de la transaction pour évaluation dans le cadre des contrôles des outils de fraude avancés, définissez Skip Fraud Checks on Admin Orders sur
Yes
pour les commandes passées via l’administrateur. -
Définissez le Bypass Fraud Protection Threshold de sorte que les
Advanced Fraud Protection
vérifications soient contournées lorsque le seuil est atteint ou dépassé.Si vous laissez ce champ vide, cette option est désactivée.
-
Si vous souhaitez que le système enregistre un fichier journal des interactions entre votre magasin et votre Braintree, définissez Debug sur
Yes
. -
Pour obliger les clients à fournir le code de sécurité à trois chiffres depuis l’arrière d’une carte de crédit, définissez CVV Verification sur
Yes
.Si vous utilisez la vérification CVV, veillez à activer AVS et/ou CVV dans la section Paramètres/Traitement de votre compte de Braintree.
-
Pour envoyer les articles du panier pour tous les modes de paiement, définissez Send Card Line Items sur
Yes
. -
Pour Credit Card Types, sélectionnez chaque carte de crédit acceptée par votre boutique comme paiement par le biais de Braintree.
Pour sélectionner plusieurs types de carte, maintenez la touche Ctrl (PC) ou la touche Commande (Mac) enfoncée, puis cliquez sur chaque option.
-
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel le Braintree apparaît lorsqu’il est répertorié avec d’autres méthodes de paiement lors du passage en caisse.
Étape 4 : Définition des paramètres du webhook du Braintree
-
Définissez Enable Webhook sur
Yes
pour activer la fonctionnalité webhook pour la protection contre la fraude, les paiements ACH et les méthodes de paiement locales. -
Copiez l’URL dans le champ Fraud Protection URL et ajoutez-la à votre compte de Braintree en tant que Webhook Destination URL.
note important IMPORTANT Cette URL doit être sécurisée et accessible au public. -
Définissez le champ Fraud Protection Approve Order Status pour déterminer quand la protection contre la fraude est approuvée par Braintree.
L’état de la commande sélectionnée est affecté à la commande Commerce.
-
Définissez le champ Fraud Protection Reject Order Status pour déterminer quand la protection contre la fraude est rejetée par le Braintree.
L’état de la commande sélectionnée est affecté à la commande Commerce.
Étape 5 : Renseigner les paramètres spécifiques au pays
-
Définissez Payment from Applicable Countries sur l’une des options suivantes :
All Allowed Countries
- Les clients de tous les pays spécifiés dans votre configuration de magasin peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste Payment from Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays de la liste dans lequel les clients peuvent effectuer des achats dans votre boutique.
{width="600" modal="regular"}
-
Pour configurer Country Specific Credit Card Types :
-
Cliquez sur Add.
-
Définissez le Country et choisissez chaque Allowed Credit Card Type.
-
Répétez cette procédure pour identifier les cartes de crédit acceptées dans chaque pays.
-
Étape 6 : achèvement de l’ACCÈS via les paramètres du Braintree
-
Pour inclure ACH comme option de paiement avec Braintree, définissez Enable ACH Direct Debit sur
Yes
. -
Les clients peuvent coffre-fort leur méthode de paiement à usage unique ACH Direct Debit et le stocker pour une utilisation ultérieure. Une fois la valeur définie, les clients peuvent réutiliser le débit direct ACH sans avoir à entrer à nouveau ou à authentifier leurs informations de paiement si la valeur Enable Vault for ACH Direct Debit est définie sur
Yes
. -
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel l’option de paiement ACH du Braintree apparaît lorsqu’elle est répertoriée avec d’autres options de paiement lors du passage en caisse.
Étape 7 : terminez le Apple Pay par les paramètres du Braintree
-
Pour inclure Apple Pay comme option de paiement avec Braintree, définissez Enable ApplePay through Braintree sur
Yes
.Veillez tout d'abord à vérifier votre nom de domaine dans votre compte de Braintree.
-
Si vous souhaitez pouvoir stocker les informations sur les clients en toute sécurité, afin que les clients n’aient pas à les ré-entrer chaque fois qu’ils effectuent un achat avec Apple Pay, définissez Enable Vault for ApplePay sur
Yes
. -
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Approuve l’achat et met un frein aux fonds. Le montant n’est pas retiré du compte bancaire du client tant que la vente n’a pas été capturée par le commerçant.Intent Sale
- Le montant de l’achat est autorisé et immédiatement retiré du compte du client.
-
Pour Merchant Name, saisissez le texte qui spécifie le libellé affiché pour les clients dans la boîte de dialogue Payer Apple.
-
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel l’option de paiement Apple Pay apparaît lorsqu’elle est répertoriée avec d’autres options de paiement lors du passage en caisse.
Etape 8 : paramétrage des modes de paiement locaux
-
Pour inclure les méthodes de paiement locales comme option de paiement avec Braintree, définissez Enable Local Payment Methods sur
Yes
. -
Pour Title, saisissez le texte à utiliser pour le libellé qui apparaît dans la section Mode de paiement de passage en caisse (valeur par défaut :
Local Payments
). -
Pour Fallback Button Text, saisissez le texte à utiliser pour le bouton qui s’affiche sur la page du Braintree de secours pour ramener le client sur le site web (par exemple,
Complete Checkout
). -
Pour Redirect on Fail, saisissez l’URL vers laquelle les clients doivent être redirigés lorsque les transactions du mode de paiement local sont annulées, échouent ou rencontrent des erreurs. Il doit s’agir de la page de paiement du passage en caisse (par exemple,
https://www.domain.com/checkout#payment
). -
Pour Allowed Payment Methods, 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){width="600" modal="regular"}
note note 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. -
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel le mode de paiement local apparaît lorsqu’il est répertorié avec d’autres options de paiement lors du passage en caisse.
Étape 9 : terminez le Google Pay par les paramètres du Braintree
-
Pour inclure Google Pay comme option de paiement avec Braintree, définissez Enable GooglePay Through Braintree sur
Yes
. -
Si vous souhaitez pouvoir stocker les informations sur les clients en toute sécurité, afin que les clients n’aient pas à les ré-entrer chaque fois qu’ils effectuent un achat avec le paiement Google, définissez Enable Vault for GooglePay sur
Yes
. -
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Approuve l’achat et met un frein aux fonds. Le montant n’est pas retiré du compte bancaire du client tant que la vente n’a pas été capturée par le commerçant.Intent Sale
- Le montant de l’achat est autorisé et immédiatement retiré du compte du client.
-
Définissez Button Color pour déterminer la couleur du bouton Google Pay :
White
ouBlack
-
Pour Merchant ID, saisissez votre MerchantID (fourni par Google).
-
Pour Accepted Cards, sélectionnez le type de carte qu’un client peut utiliser pour passer une commande à l’aide de Google Pay.
Options :
Visa
/MasterCard
/AMEX
/Discover
/JCB
-
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel Google Pay apparaît lorsqu’il est répertorié avec d’autres options de paiement lors du passage en caisse.
Étape 10 : achèvement de Venmo via les paramètres du Braintree
-
Pour inclure Venmo comme option de paiement avec Braintree, définissez Enable Venmo through Braintree sur
Yes
. -
Définissez Enable Vault for Venmo sur
Yes
pour permettre l’utilisation d’un coffre sécurisé pour stocker le compte Venmo des clients afin que les clients n’aient pas besoin de se reconnecter à leur compte Venmo pour de futures transactions.{width="600" modal="regular"}
-
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Approuve l’achat et met un frein aux fonds. Le montant n’est pas retiré du compte bancaire du client tant que la vente n’a pas été capturée par le commerçant.Intent Sale
- Le montant de l’achat est autorisé et immédiatement retiré du compte du client.
-
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel Venmo apparaît lorsqu’il est répertorié avec d’autres options de paiement lors du passage en caisse.
Étape 11 : achèvement de PayPal via les paramètres du Braintree
-
Pour inclure PayPal comme option de paiement avec Braintree, définissez Enable PayPal through Braintree sur
Yes
. -
Spécifiez votre méthode de paiement PayPal par Braintree :
note note 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. -
Pour inclure PayPal Credit comme option de paiement avec Braintree, définissez Enable PayPal Credit through Braintree sur
Yes
.Lorsque Activer PayPal via Braintree est défini sur
Yes
, seul ce champ s’affiche.note note NOTE PayPal Credit est disponible uniquement aux États-Unis et au Royaume-Uni. Le crédit PayPal est désactivé si la valeur sélectionnée pour le champ Merchant Country n’est pas US
ouUK
. -
Pour inclure PayPal PayLater comme option de paiement avec Braintree, définissez Enable PayPal PayLater through Braintree sur
Yes
.Lorsque Enable PayPal PayLater through Braintree est défini sur
Yes
, seul ce champ s’affiche.Vous pouvez afficher des messages PayLater sur votre site pour les offres, par exemple Payer dans 3, ce qui permet aux clients de payer trois mensualités sans intérêts. L’intégration de Braintree peut afficher des messages sur votre site pour promouvoir cette fonctionnalité. Vous ne pouvez pas promouvoir des offres PayLater avec tout autre contenu, contenu marketing ou matériel.
-
-
Pour Title, saisissez un titre qui identifie l’option de paiement du Braintree par PayPal lors du passage en caisse.
-
Définissez Vault Enabled sur
Yes
pour permettre l’utilisation d’un coffre sécurisé afin de stocker le compte PayPal des clients. Un compte PayPal valide peut être utilisé pour les transactions ultérieures, ce qui réduit le nombre d’étapes pour les clients. -
Définissez Send Cart Line Items for PayPal sur
Yes
pour envoyer 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, l’expédition et la taxe comme éléments de ligne. -
Pour Sort Order, saisissez un nombre afin de déterminer l’ordre dans lequel l’option de paiement PayPal du Braintree apparaît lorsqu’elle est répertoriée avec d’autres options de paiement lors du passage en caisse.
-
Pour afficher votre nom commercial différemment de ce qui est défini dans votre configuration de magasin, saisissez le nom dans le champ Override Merchant Name tel que vous souhaitez le voir apparaître.
-
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Approuve l’achat et met un frein aux fonds. Le montant n’est pas retiré du compte bancaire du client tant que la vente n’a pas été capturée par le commerçant.Authorize and Capture
- Le montant de l’achat est autorisé et immédiatement retiré du compte du client.
-
Définissez Payment from Applicable Countries sur l’une des valeurs suivantes pour les transactions du Braintree traitées par PayPal :
All Allowed Countries
- Les clients de tous les pays spécifiés dans votre configuration de magasin peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste Payment from Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays de la liste dans lequel les clients peuvent effectuer des achats dans votre boutique.
-
Pour obliger les clients à fournir une adresse de facturation, définissez Require Customer’s Billing Address sur
Yes
.note note NOTE Cette fonctionnalité doit être activée pour votre compte par le support technique de PayPal. -
Pour enregistrer un fichier journal des interactions entre votre boutique et PayPal via Braintree, définissez Debug sur
Yes
. -
Pour afficher le bouton PayPal sur la page du mini panier et du panier, définissez Display on Shopping Cart sur
Yes
.
Étape 12 : Définition des paramètres de style
-
Pour Location, choisissez l’emplacement de rendu des boutons et messages PayPal :
Mini-Cart and Cart Page
,Checkout Page
ouProduct Page
{width="600" modal="regular"}
Mini-Cart and Cart Page
Les options et paramètres de cette section varient en fonction du paramètre défini dans le champ Location.
- Définissez PayPal Button Type sur l’un des trois types de boutons :
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.
-
Pour afficher le bouton PayPal sur le storefront à l’emplacement sélectionné, définissez Show PayPal Button sur
Yes
. -
Pour Button Label, sélectionnez l’étiquette du bouton PayPal :
Paypal
,Checkout
,Buynow
ouPay
-
Pour Color, sélectionnez la couleur du bouton PayPal :
Blue
,Black
,Gold
ouSilver
-
Pour Shape, sélectionnez la forme de bouton PayPal :
Pill
ouRectangle
-
Pour Size (Deprecated), sélectionnez la taille du bouton PayPal :
Medium
,Large
ouResponsive
PayLater Messaging
-
Pour afficher la messagerie PayLater sur le storefront à l’emplacement sélectionné, définissez Show PayLater Messaging sur
Yes
.Ce message inclut l’affichage de PayLater messages pour les offres disponibles (restrictions appliquées).
-
Pour Message Layout, sélectionnez la disposition du message PayLater :
Text
ouFlex
-
Pour Logo, sélectionnez le type de logo PayPal :
Inline
,Primary
,Alternative
ouNone
-
Pour Logo Position, sélectionnez la position du logo PayPal :
Left
,Right
ouTop
-
Pour Text Color, sélectionnez la couleur du texte du message PayLater :
Black
,White
,Monochrome
ouGrayscale
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 :
-
Pour stocker les paramètres de style sélectionnés pour les boutons et la messagerie PayLater et les appliquer à l’emplacement actuel et au type de bouton actuel, cliquez sur Apply.
-
pour stocker les paramètres de style sélectionnés pour les boutons et les valeurs de messagerie PayLater et les appliquer à tous les types de boutons et emplacements, cliquez sur Apply to All Buttons.
-
Pour renvoyer les paramètres de style aux valeurs par défaut recommandées pour les boutons et la messagerie PayLater et les appliquer à tous les types de boutons et emplacements, cliquez sur Reset to Recommended Defaults.
Étape 13 : définition des paramètres de vérification 3D
-
Si vous souhaitez ajouter une étape de vérification pour les clients utilisant des cartes de crédit qui sont inscrits dans un programme de vérification (par exemple Vérifié par VISA), définissez 3D Secure Verification sur
Yes
.Au cours du processus, le montant de la transaction qui est soumis à vérification est comparé au montant envoyé pour autorisation.
-
Pour toujours contester la requête sécurisée 3D pour toutes les transactions, définissez Always request 3DS sur
Yes
. -
Pour Threshold Amount, saisissez le montant minimum de commande nécessaire pour déclencher la vérification 3D.
-
Définissez Verify for Applicable Countries sur l’une des options suivantes :
All Allowed Countries
- Les clients de tous les pays spécifiés dans votre configuration de magasin peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste Verify for Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays de la liste dans lequel les clients peuvent effectuer des achats dans votre boutique.
{width="600" modal="regular"}
Étape 14 : configuration des descripteurs dynamiques du Braintree
Les descripteurs suivants sont utilisés pour identifier les achats sur les relevés de carte de crédit client. Vous pouvez réduire le nombre de rebonds en identifiant clairement la société associée à chaque achat. Si les descripteurs dynamiques ne sont pas activés pour votre compte, contactez l’assistance du Braintree.
-
Saisissez le descripteur dynamique pour Name, Phone et URL en fonction des instructions suivantes :
-
Name - Le descripteur de nom comporte deux parties, séparées par un astérisque (*). Par exemple :
company*myproduct
La première partie du descripteur identifie la société ou l’application de données côté serveur et la deuxième partie identifie le produit. La longueur des parties
company
etproduct
du descripteur peut être allouée comme suit, pour une longueur combinée allant jusqu’à 22 caractères.Caractères dans le descripteur de nom
Option 1 :
Company
doit comporter trois caractères,Product
peut comporter jusqu’à 18 caractères.Option 2 :
Company
doit comporter sept caractères,Product
peut comporter jusqu’à 14 caractèresOption 3 :
Company
doit comporter 12 caractères,Product
peut comporter jusqu’à neuf caractères. -
Phone - Le descripteur de téléphone doit comporter de 10 à 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 - Le descripteur d’URL représente votre nom de domaine et peut contenir jusqu’à 13 caractères. Par exemple :
company.com
-
-
Une fois la configuration de votre Braintree terminée, cliquez sur Save Config.
Notes de mise à niveau 2.4
À partir d’Adobe Commerce et de Magento Open Source 2.4.0, l’extension Braintree est incluse dans la version. Si vous effectuez une migration vers Commerce 2.4.x à partir d’une version antérieure à 2.4.0 dans laquelle l’extension de Braintree Marketplace est installée, vous devez désinstaller cette extension (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 principale du Braintree Commerce les paiements regroupés et l’extension distribuée sur le Commerce Marketplace persistent et les paiements placés avec ces versions précédentes peuvent toujours être capturés, annulés ou remboursés normalement.