Braintree

Braintree offre une expérience de paiement entièrement personnalisable avec détection des fraudes et intégration PayPal. Il prend en charge Apple Pay, Google Pay, ACH, Venmo et les modes de paiement locaux. Le 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.

NOTE
Si vous effectuez une mise à niveau vers la version 2.4.x à partir d’une version antérieure d’Adobe Commerce ou d’un Magento Open Source avec l’extension de Braintree du Commerce Marketplace installé, consultez la Notes de mise à niveau vers 2.4 à la fin de cette page.

Étape 1 : obtenir les informations d’identification de votre Braintree

Accéder à Paiements Braintree et vous inscrire à un compte.

Étape 2 : définition des paramètres de base

  1. Le Admin barre latérale, accéder à Stores > Settings>Configuration.

  2. 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 l’option Store View où la configuration s’applique.

    • Dans le Merchant Location, vérifiez que Merchant Country ​est défini sur l’emplacement de votre entreprise.

  3. Sous Recommended Solutions, dans le_Braintree Payments (par GENE Commerce v4.6.1 - Notes de mise à jour_, cliquez sur Configure.

    Configurer le Braintree {width="600" modal="regular"}

  4. Pour Title, saisissez un titre qui identifie Braintree comme option de paiement lors du passage en caisse.

  5. Définir le fonctionnement actuel Environment pour les transactions Braintree vers Sandbox ou Production

    Lors du test de la configuration dans un sandbox, utilisez uniquement numéros de carte de crédit recommandés par Braintree. Lorsque vous êtes prêt à passer en production avec Braintree, définissez Environment vers Production.

    Paramètres des informations d’identification de base {width="600" modal="regular"}

  6. Définir Payment Action à l’un des éléments suivants :

    • Authorize Only - Valide l'achat et bloque les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas capturé par le marchand.|
    • 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 2.3.x et les versions antérieures.|
  7. Saisir le Sandbox Merchant ID / Merchant ID à partir de votre compte de Braintree.

  8. Saisissez les informations d’identification suivantes à partir du compte de votre Braintree :

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note note
    NOTE
    Il existe des champs distincts pour les deux (Sandbox et production) et les autres champs s’affichent en fonction de l’environnement sélectionné.
  9. Avant d’enregistrer la configuration, cliquez sur Validate Credentials pour valider vos informations d’identification.

  10. Définir Enable Card Payments vers Yes.

    Basic Settings {width="600" modal="regular"}

    Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à chaque achat, définissez Enable Vault for Card Payments vers Yes.

Étape 3 : définition des paramètres avancés

  1. Développer Sélecteur d’extension le Advanced Braintree Settings section.

    Paramètres avancés {width="550" modal="regular"}

  2. Pour 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.

  3. Saisir le Merchant Account ID à partir 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.

  4. Pour offrir une expérience de paiement plus rapide avec les options de paiement express au début du processus de paiement, notamment PayPal, PayLater, Apple Pay et Google Pay, définissez Enable Checkout Express Payments vers Yes.

  5. Pour empêcher l'envoi de la transaction pour évaluation dans le cadre des contrôles des outils antifraude avancés, sur les commandes passées via l'administrateur, définissez Skip Fraud Checks on Admin Orders vers Yes.

  6. Définir le Bypass Fraud Protection Threshold afin que le Advanced Fraud Protection les contrôles sont ignorés lorsque le seuil est atteint ou dépassé.

    Si vous ne renseignez pas ce champ, cette option est désactivée.

  7. Si vous souhaitez que le système enregistre un fichier journal des interactions entre votre magasin et votre Braintree, définissez Debug vers Yes.

  8. Pour demander aux clients de fournir le code de sécurité à trois chiffres au verso d’une carte de crédit, définissez CVV Verification vers Yes.

    Si vous utilisez la vérification CVV, veillez à activer AVS et/ou CVV dans le Paramètres/Traitement de votre compte de Braintree.

  9. Pour envoyer les articles de la ligne de panier pour tous les modes de paiement, définissez Send Card Line Items vers Yes.

  10. Pour Credit Card Types, sélectionnez chaque carte de crédit acceptée par votre boutique en tant que paiement par Braintree.

    Pour sélectionner plusieurs types de carte, maintenez la touche Ctrl (PC) ou Commande (Mac) enfoncée et cliquez sur chaque option.

  11. Pour Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel le Braintree apparaît lorsqu'il est indiqué avec d'autres modes de paiement lors du passage en caisse.

Étape 4 : définir les paramètres du Webhook du Braintree

Paramètres des Webhooks du Braintree {width="600" modal="regular"}

  1. Définir Enable Webhook vers Yes pour activer la fonctionnalité webhook pour la protection contre la fraude, les paiements ACH et les méthodes de paiement locales.

  2. Copiez l’URL dans le Fraud Protection URL et ajoutez-le à votre compte de Braintree en tant que Webhook Destination URL.

    note important
    IMPORTANT
    Cette URL doit être sécurisée et accessible au public.
  3. Définir le Fraud Protection Approve Order Status pour déterminer quand la protection contre la fraude est approuvée par le Braintree.

    Le statut de la commande sélectionnée est affecté à la commande Commerce.

  4. Définir le Fraud Protection Reject Order Status champ permettant de déterminer à quel moment la protection contre la fraude est rejetée par le Braintree.

    Le statut de la commande sélectionnée est affecté à la commande Commerce.

Étape 5 : définition des paramètres spécifiques au pays

  1. Définir Payment from Applicable Countries à l’un des éléments suivants :

    • All Allowed Countries - Clients de tous les pays spécifié dans la configuration de votre boutique peut utiliser ce mode de paiement.
    • Specific Countries - Après avoir choisi cette option, le Payment from Specific Countries ​La liste 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 spécifiques au pays {width="600" modal="regular"}

  2. À configurer Country Specific Credit Card Types:

    • Clic Add.

    • Définir le 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 du Braintree

ACH via Braintree {width="600" modal="regular"}

  1. Pour inclure ACH comme option de paiement avec Braintree, définissez Enable ACH Direct Debit vers Yes.

  2. 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 voûté, le client peut réutiliser ACH Direct Debit sans avoir à entrer à nouveau ou authentifier ses informations de paiement si elles sont définies Enable Vault for ACH Direct Debit vers Yes.

  3. Pour Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel l'option de paiement ACH Braintree apparaît lorsqu'elle est répertoriée avec d'autres options de paiement lors du passage en caisse.

Étape 7 : effectuez l’opération Apple Pay via les paramètres du Braintree

ApplePay via les paramètres du Braintree {width="600" modal="regular"}

  1. À inclure Apple Pay comme option de paiement avec Braintree, définissez Enable ApplePay through Braintree vers Yes.

    Veillez à vérifier votre nom de domaine dans votre compte de Braintree en premier.

  2. Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à chaque fois qu’ils effectuent un achat avec Apple Pay, définissez Enable Vault for ApplePay vers Yes.

  3. Définir Payment Action à l’un des éléments suivants :

    • Authorize Only - Valide l'achat et bloque les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas capturé par le marchand.
    • Intent Sale - Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
  4. Pour Merchant Name, saisissez le texte qui spécifie le libellé affiché pour les clients dans la boîte de dialogue Apple Pay.

  5. Pour Sort Order, saisissez un nombre pour déterminer l’ordre dans lequel Apple Pay l’option de paiement apparaît lorsqu’elle est répertoriée avec d’autres options de paiement lors du passage en caisse.

Etape 8 : Renseigner les paramètres des modes de paiement locaux

  1. Pour inclure les modes de paiement locaux comme option de paiement avec Braintree, définissez Enable Local Payment Methods vers Yes.

  2. Pour 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).

  3. Pour Fallback Button Text, saisissez le texte à utiliser pour le bouton qui s’affiche sur la page du Braintree de secours afin de renvoyer le client sur le site web (par exemple, Complete Checkout).

  4. 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 de la commande (par exemple, https://www.domain.com/checkout#payment).

  5. 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)

    Paramètres des modes de paiement locaux {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 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.
  6. Pour Sort Order, saisissez un numéro 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 lors du passage en caisse.

Étape 9 : effectuez l’opération Google Pay via les paramètres du Braintree

Google Pay through Braintree {width="600" modal="regular"}

  1. À inclure Google Pay comme option de paiement avec Braintree, définissez Enable GooglePay Through Braintree vers Yes.

  2. Si vous souhaitez pouvoir stocker les informations client en toute sécurité, afin que les clients n’aient pas à les saisir à chaque fois qu’ils effectuent un achat avec Google Pay, définissez Enable Vault for GooglePay vers Yes.

  3. Définir Payment Action à l’un des éléments suivants :

    • Authorize Only - Valide l'achat et bloque les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas capturé par le marchand.
    • Intent Sale - Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
  4. Définir Button Color pour déterminer la couleur du Google Pay bouton : White ou Black

  5. Pour Merchant ID, saisissez votre MerchantID (fourni par Google).

  6. Pour Accepted Cards, sélectionnez le type de cartes qu’un client peut utiliser pour passer une commande Google Pay.

    Options : Visa / MasterCard / AMEX / Discover / JCB

  7. Pour Sort Order, saisissez un nombre pour déterminer l’ordre dans lequel Google Pay apparaît lorsqu’elle est répertoriée avec d’autres options de paiement lors du passage en caisse.

Étape 10 : terminer Venmo via les paramètres du Braintree

  1. Pour inclure Venmo comme option de paiement avec Braintree, définissez Enable Venmo through Braintree vers Yes.

  2. Définir Enable Vault for Venmo vers Yes pour permettre l’utilisation d’un coffre sécurisé afin de stocker le compte Venmo des clients et clientes, de sorte qu’ils n’aient plus à se connecter à leur compte Venmo pour de futures transactions.

    Venmo via Braintree {width="600" modal="regular"}

  3. Définir Payment Action à l’un des éléments suivants :

    • Authorize Only - Valide l'achat et bloque les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas capturé par le marchand.
    • Intent Sale - Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
  4. Pour Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel Venmo apparaît lorsqu'il est mis en vente avec d'autres options de paiement lors du passage en caisse.

Étape 11 : Compléter PayPal via les paramètres du Braintree

PayPal via les paramètres du Braintree {width="550" modal="regular"}

  1. Pour inclure PayPal comme option de paiement avec Braintree, définissez Enable PayPal through Braintree vers Yes.

  2. Spécifiez votre PayPal par le biais du mode de paiement par Braintree :

    note note
    NOTE
    Soit PayPal Credit ou PayPal PayLater peut être activé. Les deux méthodes ne peuvent pas être activées simultanément.
    • À inclure PayPal Credit comme option de paiement avec Braintree, définissez Enable PayPal Credit through Braintree vers Yes.

      Lorsque Activer PayPal via Braintree est défini sur Yes, seul ce champ apparaît.

      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 Merchant Country ​le champ n’est pas US ou UK.
    • À inclure PayPal PayLater comme option de paiement avec Braintree, définissez Enable PayPal PayLater through Braintree vers Yes.

      Lorsque Enable PayPal PayLater through Braintree est défini sur Yes, seul ce champ apparaît.

      Vous pouvez afficher des messages PayLater sur votre site pour des offres telles que : Payer en 3, qui permet aux clients de payer avec trois mensualités sans intérêt. L’intégration du 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.

  3. Pour Title, saisissez un titre qui identifie le paiement du Braintree par PayPal lors du passage en caisse.

  4. Définir Vault Enabled vers 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.

  5. Définir Send Cart Line Items for PayPal vers 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.

  6. Pour Sort Order, saisissez un nombre pour 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.

  7. Pour afficher le nom de votre commerçant différemment de ce qui est défini dans votre configuration du magasin, saisissez le nom dans le champ Override Merchant Name champ tel que vous souhaitez qu’il apparaisse.

  8. Définir Payment Action à l’un des éléments suivants :

    • Authorize Only - Valide l'achat et bloque les fonds. Le montant n'est pas retiré du compte bancaire du client tant que la vente n'est pas capturé par le marchand.
    • Authorize and Capture - Le montant de l'achat est autorisé et immédiatement retiré du compte du client.
  9. Définir Payment from Applicable Countries à l'une des options suivantes pour les transactions de Braintree traitées par PayPal :

    • All Allowed Countries - Clients de tous les pays spécifié dans la configuration de votre boutique peut utiliser ce mode de paiement.
    • Specific Countries - Après avoir choisi cette option, le Payment from Specific Countries ​La liste 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.
  10. Pour demander aux clients de fournir une adresse de facturation, définissez Require Customer’s Billing Address vers Yes.

    note note
    NOTE
    Cette fonctionnalité doit être activée pour votre compte par le support technique PayPal.
  11. Pour enregistrer un fichier journal des interactions entre votre boutique et PayPal par Braintree, définissez Debug vers Yes.

  12. Pour afficher le bouton PayPal sur la page du mini panier et du panier, définissez Display on Shopping Cart vers Yes.

Étape 12 : définir les paramètres de style

  1. Pour Location, choisissez l’emplacement où les boutons et messages PayPal sont rendus : Mini-Cart and Cart Page, Checkout Page, ou Product Page

    Paramètres de style PayPal {width="600" modal="regular"}

Mini-Cart and Cart Page

Les options et paramètres de cette section varient en fonction du paramètre du Location ​champ .

  1. Définir 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 PayPal Button Type ​champ .

  1. Pour afficher le bouton PayPal sur le storefront à l'emplacement sélectionné, définissez Show PayPal Button vers Yes.

  2. Pour Button Label, sélectionnez le libellé du bouton PayPal : Paypal, Checkout, Buynow, ou Pay

  3. Pour Color, sélectionnez la couleur du bouton PayPal : Blue, Black, Gold, ou Silver

  4. Pour Shape, sélectionnez la forme du bouton PayPal : Pill ou Rectangle

  5. Pour Size (Deprecated), sélectionnez la taille du bouton PayPal : Medium, Large, ou 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

  1. À afficher PayLater messagerie sur le storefront à l'emplacement sélectionné, définissez Show PayLater Messaging vers Yes.

    Ce message inclut l’affichage de PayLater messagerie pour les offres disponibles (restrictions s’appliquent).

  2. Pour Message Layout, sélectionnez le PayLater disposition du message : Text ou Flex

  3. Pour Logo, sélectionnez le type de logo PayPal : Inline, Primary, Alternative, ou None

  4. Pour Logo Position, sélectionnez la position du logo PayPal : Left, Right, ou Top

  5. Pour Text Color, sélectionnez le PayLater couleur du texte du message : Black, White, Monochrome, ou 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 :

  • Pour stocker les paramètres de style sélectionnés pour les boutons et les messages 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 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

  1. 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éfini 3D Secure Verification vers Yes.

    Au cours du processus, le montant de la transaction qui est soumis à vérification est vérifié par rapport au montant qui est envoyé pour autorisation.

  2. Pour toujours contester la requête 3D Secure pour toutes les transactions, définissez Always request 3DS vers Yes.

  3. Pour Threshold Amount, saisissez le montant de commande minimal requis pour déclencher la vérification 3D.

  4. Définir Verify for Applicable Countries à l’un des éléments suivants :

    • All Allowed Countries - Clients de tous les pays spécifié dans la configuration de votre boutique peut utiliser ce mode de paiement.
    • Specific Countries - Après avoir choisi cette option, le Verify for Specific Countries ​La liste 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 3D {width="600" modal="regular"}

Étape 14 : configurer les descripteurs dynamiques du 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 du Braintree.

Descripteurs dynamiques {width="600" modal="regular"}

  1. Saisissez le descripteur dynamique pour le Name, Phone, et URL conformément à ces directives :

    • 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 du company et product les parties du descripteur peuvent être attribuées des manières suivantes, pour une longueur combinée maximale de 22 caractères.

      Caractères dans le descripteur de nom

      Option 1 : Company doit contenir trois caractères, Product 18 caractères maximum

      Option 2 : Company doit contenir sept caractères, Product 14 caractères maximum

      Option 3: Company doit contenir 12 caractères, Product peut contenir neuf caractères maximum

    • 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

  2. Une fois la configuration du 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 de Braintree est incluse dans la version. Si vous migrez vers Commerce 2.4.x à partir d’une version antérieure à 2.4.0 sur laquelle l’extension de Braintree Marketplace est installée, vous devez désinstaller cette extension (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 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.

recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1