Braintree
Braintree offre une expérience de paiement entièrement personnalisable avec détection des fraudes et intégration PayPal. Il prend en charge les méthodes de paiement Apple Pay, Google Pay, ACH, Venmo et locales. Braintree réduit la charge de conformité PCI pour les commerçants, car la transaction a lieu sur le système Braintree. L’intégration de Braintree Payments est développée par GENE Commerce.
Étape 1 : obtenir vos informations d’identification Braintree
Accédez à Braintree Payments et inscrivez-vous à un compte.
Étape 2 : définition des paramètres de base
-
Dans 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, boutiques ou vues, dans le coin supérieur gauche, choisissez la 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.
-
Par Title, saisissez un titre qui identifie Braintree comme option de paiement lors du passage en caisse.
-
Définissez la Environment d’exploitation actuelle pour les transactions Braintree sur
Sandbox
ouProduction
Lors du test de la configuration dans un sandbox, utilisez uniquement les numéros de carte de crédit recommandés par Braintree. Lorsque vous êtes prêt à passer en production avec Braintree, définissez Environment sur
Production
. -
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Valide l'achat et met un blocage sur les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas 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 la version 2.3.x et les versions antérieures.|
-
Saisissez le Sandbox Merchant ID / Merchant ID de votre compte Braintree.
-
Saisissez les informations d’identification suivantes à partir de votre compte Braintree :
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE Il existe des champs distincts pour les deux environnements (Sandbox et Production) et les autres champs s’affichent 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
.Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à nouveau 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
-
Par Vault Title, saisissez un titre descriptif pour votre référence qui identifie le coffre dans lequel vos informations de carte client sont stockées.
-
Saisissez le Merchant Account ID de votre compte Braintree.
Si vous ne spécifiez pas le compte commerçant à utiliser, Braintree traite la transaction à l’aide de votre compte commerçant par défaut.
-
Pour offrir 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, définissez Enable Checkout Express Payments sur
Yes
. -
Si vous souhaitez empêcher que la transaction ne soit envoyée pour évaluation dans le cadre des contrôles des outils avancés de lutte contre la fraude, pour les commandes passées via l’administrateur, définissez Skip Fraud Checks on Admin Orders sur
Yes
. -
Définissez le Bypass Fraud Protection Threshold de sorte que les vérifications de
Advanced Fraud Protection
soient contournées lorsque le seuil est atteint ou dépassé.Si vous ne renseignez pas ce champ, cette option est désactivée.
-
Si vous souhaitez que le système enregistre un fichier journal des interactions entre votre magasin et Braintree, définissez Debug sur
Yes
. -
Pour demander aux clients de fournir le code de sécurité à trois chiffres à 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 Braintree.
-
Pour envoyer les articles de la ligne de panier pour tous les modes de paiement, définissez Send Card Line Items sur
Yes
. -
Par Credit Card Types, sélectionnez chaque carte de crédit acceptée par votre boutique en tant que paiement via Braintree.
Pour sélectionner plusieurs types de carte, maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et cliquez sur chaque option.
-
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel Braintree apparaît lorsqu'il est répertorié avec d'autres modes de paiement lors du passage en caisse.
Étape 4 : définition des paramètres du webhook Braintree
-
Définissez Enable Webhook sur
Yes
pour activer la fonctionnalité webhook pour la protection contre la fraude, les paiements ACH et les modes de paiement locaux. -
Copiez l’URL dans le champ Fraud Protection URL et ajoutez-la à votre compte 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 à quel moment la protection contre la fraude est approuvée par Braintree.
Le statut de la commande sélectionnée est affecté à la commande Commerce.
-
Définissez le champ Fraud Protection Reject Order Status pour déterminer à quel moment Braintree rejette la protection contre la fraude.
Le statut de la commande sélectionnée est affecté à la commande Commerce.
Étape 5 : remplir 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 la configuration de votre boutique peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste des Payment from Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays dans la liste où les clients peuvent effectuer des achats dans votre boutique.
-
Pour configurer Country Specific Credit Card Types :
-
Cliquez sur Add.
-
Définissez la Country et choisissez chaque Allowed Credit Card Type.
-
Répétez cette opération pour identifier les cartes de crédit acceptées dans chaque pays.
-
Étape 6 : terminer l'ACH via les paramètres Braintree
-
Pour inclure ACH comme option de paiement avec Braintree, définissez Enable ACH Direct Debit sur
Yes
. -
Les clients peuvent mettre en coffre leur méthode de paiement par prélèvement automatique ACH à usage unique et la stocker pour une utilisation ultérieure. Une fois la chambre forte utilisée, les clients peuvent réutiliser ACH Direct Debit sans avoir à entrer à nouveau ou authentifier leurs informations de paiement si elles sont définies Enable Vault for ACH Direct Debit sur
Yes
. -
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel l'option de paiement Braintree ACH apparaît lorsqu'elle est répertoriée avec d'autres options de paiement lors du passage en caisse.
Étape 7 : terminer la Apple Pay via les paramètres de Braintree
-
Pour inclure le Apple Pay en tant qu’option de paiement avec Braintree, définissez Enable ApplePay through Braintree sur
Yes
.Veillez d’abord à vérifier votre nom de domaine dans votre compte Braintree.
-
Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à nouveau 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
- Valide l'achat et met un blocage sur les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas saisie par le commerçant.Intent Sale
- Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
-
Par Merchant Name, saisissez le texte qui spécifie le libellé affiché pour les clients dans la boîte de dialogue Apple Pay.
-
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel Apple Pay'option de paiement apparaît lorsqu'elle est répertoriée avec d'autres options de paiement lors du passage en caisse.
Étape 8 : Complétez les paramètres pour les modes de paiement locaux
-
Pour inclure les modes de paiement locaux en tant qu'option de paiement avec Braintree, définissez Enable Local Payment Methods sur
Yes
. -
Par Title, saisissez le texte à utiliser pour le libellé qui apparaît dans la section Mode de paiement de la commande (valeur par défaut :
Local Payments
). -
Par Fallback Button Text, saisissez le texte à utiliser pour le bouton qui s’affiche sur la page Braintree de secours pour renvoyer le client sur le site web (par exemple,
Complete Checkout
). -
Par Redirect on Fail, saisissez l'URL vers laquelle 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
). -
Par 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)note note NOTE L’extension Braintree groupée ne prend pas en charge tous les modes de paiement locaux répertoriés dans la documentation du développeur Braintree. D’autres méthodes de paiement locales sont en cours de développement et seront prises en charge dans les prochaines versions. -
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel le mode de paiement local apparaît lorsqu'il est répertorié avec d'autres options de paiement pendant le passage en caisse.
Étape 9 : terminer la Google Pay via les paramètres de Braintree
-
Pour inclure le Google Pay en tant qu’option de paiement avec Braintree, définissez Enable GooglePay Through Braintree sur
Yes
. -
Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à nouveau chaque fois qu’ils effectuent un achat avec Google Pay, définissez Enable Vault for GooglePay sur
Yes
. -
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Valide l'achat et met un blocage sur les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas saisie 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
-
Par Merchant ID, saisissez votre MerchantID (fourni par Google).
-
Par Accepted Cards, sélectionnez le type de cartes qu’un client peut utiliser pour passer une commande à l’aide de Google Pay.
Options :
Visa
/MasterCard
/AMEX
/Discover
/JCB
-
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel le Google Pay apparaît lorsqu'il est répertorié avec d'autres options de paiement lors du passage en caisse.
Étape 10 : terminer Venmo via les paramètres de Braintree
-
Pour inclure Venmo en tant qu'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 qu’ils n’aient plus besoin de se connecter à leur compte Venmo pour les transactions futures. -
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Valide l'achat et met un blocage sur les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas saisie par le commerçant.Intent Sale
- Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
-
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel Venmo apparaît lorsqu'il est répertorié avec d'autres options de paiement pendant le passage en caisse.
Étape 11 : Compléter PayPal via les paramètres Braintree
-
Pour inclure PayPal comme option de paiement avec Braintree, définissez Enable PayPal through Braintree sur
Yes
. -
Spécifiez votre PayPal via le mode de paiement Braintree :
note note NOTE PayPal Credit ou PayPal PayLater peuvent être activés. Les deux méthodes ne peuvent pas être activées simultanément. -
Pour inclure le PayPal Credit en tant qu’option de paiement avec Braintree, définissez Enable PayPal Credit through Braintree sur
Yes
.Lorsque l’option Activer PayPal via Braintree est définie 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 le PayPal PayLater en tant qu’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 apparaît.Vous pouvez afficher la messagerie PayLater sur votre site pour les offres, comme Pay in 3, qui permet aux clients de payer avec trois paiements mensuels sans intérêt. 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, marketing ou matériel.
-
-
Par Title, saisissez un titre qui identifie l'option de paiement Braintree par PayPal lors du passage en caisse.
-
Définissez Vault Enabled sur
Yes
pour permettre l’utilisation d’un coffre sécurisé pour stocker le compte PayPal des clients. Un compte PayPal sécurisé peut être utilisé pour les transactions futures, ce qui réduit le nombre d'étapes pour les clients. -
Définissez Send Cart Line Items for PayPal sur
Yes
pour envoyer les objets de ligne (objets de commande) à PayPal avec les cartes-cadeaux, l'emballage-cadeau pour les objets, l'emballage-cadeau pour la commande, le crédit de magasin, l'expédition et la taxe comme objets de ligne. -
Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel l'option de paiement Braintree PayPal apparaît lorsqu'elle est répertoriée avec d'autres options de paiement lors du passage en caisse.
-
Pour afficher le nom de votre commerçant différemment de ce qui est défini dans la configuration de votre boutique, saisissez le nom tel que vous souhaitez qu’il apparaisse dans le champ Override Merchant Name.
-
Définissez Payment Action sur l’une des options suivantes :
Authorize Only
- Valide l'achat et met un blocage sur les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas saisie 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 Braintree traitées par PayPal :
All Allowed Countries
- Les clients de tous les pays spécifiés dans la configuration de votre boutique peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste des Payment from Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays dans la liste où les clients peuvent effectuer des achats dans votre boutique.
-
Pour demander aux clients de 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 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éfinir les paramètres de style
-
Par Location, choisissez l’emplacement où les boutons et messages PayPal sont rendus :
Mini-Cart and Cart Page
,Checkout Page
ouProduct Page
Mini-Cart and Cart Page
Les options et paramètres de cette section varient en fonction du paramètre du 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
. -
Par Button Label, sélectionnez le libellé du bouton PayPal :
Paypal
,Checkout
,Buynow
ouPay
-
Par Color, sélectionnez la couleur du bouton PayPal :
Blue
,Black
,Gold
ouSilver
-
Par Shape, sélectionnez la forme du bouton PayPal :
Pill
ouRectangle
-
Par Size (Deprecated), sélectionnez la taille du bouton PayPal :
Medium
,Large
ouResponsive
PayLater Messaging
-
Pour afficher PayLater message sur le storefront à l’emplacement sélectionné, définissez Show PayLater Messaging sur
Yes
.Ce message inclut l’affichage d’un message PayLater pour les offres disponibles (des restrictions s’appliquent).
-
Par Message Layout, sélectionnez la disposition PayLater du message :
Text
ouFlex
-
Par Logo, sélectionnez le type de logo PayPal :
Inline
,Primary
,Alternative
ouNone
-
Par Logo Position, sélectionnez la position du logo PayPal :
Left
,Right
ouTop
-
Par Text Color, sélectionnez la couleur de 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 certaines 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 les messages PayLater et les appliquer à l'emplacement et au type de bouton actuels, cliquez sur Apply.
-
pour stocker les paramètres de style sélectionnés pour les boutons et les valeurs de message PayLater et les appliquer à tous les types de boutons et emplacements, cliquez sur Apply to All Buttons.
-
Pour rétablir les paramètres de style aux valeurs par défaut recommandées pour les boutons et les messages PayLater et les appliquer à tous les types de boutons et emplacements, cliquez sur Reset to Recommended Defaults.
Étape 13 : compléter les 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 à un programme de vérification (tel que Vérifié par VISA), définissez 3D Secure Verification sur
Yes
.Au cours du processus, le montant de la transaction soumis à vérification est comparé au montant envoyé pour autorisation.
-
Pour toujours contester la requête 3D Secure pour toutes les transactions, définissez Always request 3DS sur
Yes
. -
Par Threshold Amount, saisissez le montant minimum de commande requis 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 la configuration de votre boutique peuvent utiliser ce mode de paiement.Specific Countries
- Après avoir choisi cette option, la liste des Verify for Specific Countries s’affiche. Maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et sélectionnez chaque pays dans la liste où les clients peuvent effectuer des achats dans votre boutique.
Paramètres de vérification
Étape 14 : Configurer les descripteurs dynamiques Braintree
Les descripteurs suivants sont utilisés pour identifier les achats sur les relevés de carte de crédit du client. Vous pouvez réduire le nombre de refacturations 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 Braintree.
-
Saisissez le descripteur dynamique pour le Name, le Phone et le URL conformément à ces instructions :
-
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'administrateur de base de données, et la seconde partie identifie le produit. La longueur des parties
company
etproduct
du descripteur peut être attribuée comme suit, pour une longueur combinée maximale de 22 caractères.Caractères dans le descripteur de nom
Option 1 :
Company
doit comporter trois caractères,Product
18 caractères au maximumOption 2 :
Company
doit comporter sept caractères,Product
14 caractères au maximumOption 3 :
Company
doit comporter 12 caractères,Product
peut contenir jusqu'à neuf caractères -
Phone - Le descripteur de téléphone 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 - 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 Braintree terminée, cliquez sur Save Config.
Notes de mise à niveau vers 2.4
À partir d’Adobe Commerce et de Magento Open Source 2.4.0, l’extension Braintree est incluse dans la version. Si vous migrez vers Commerce 2.4.x à partir d’une version antérieure à la version 2.4.0 sur laquelle l’extension Marketplace Braintree est installée, vous devez désinstaller cette extension (paypal/module-braintree
ou gene/module-braintree
) et mettre à jour toutes les personnalisations de code pour utiliser l’espace de noms PayPal_Braintree
au lieu de Magento_Braintree
. Les paramètres de configuration de l’extension principale Commerce Braintree Payments et de l’extension distribuée sur 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.