Braintree

Braintree biedt een volledig aanpasbare uitcheckervaring met fraudedetectie en PayPal-integratie. Het ondersteunt Apple Pay, Google Pay, ACH, Venmo en lokale betalingsmethoden. Braintree vermindert de PCI nalevingslast voor handelaren omdat de transactie op het systeem van de Braintree plaatsvindt. De integratie van Braintree Payments wordt ontwikkeld door GENE Commerce.

NOTE
Als u een upgrade uitvoert naar 2.4.x vanuit een eerdere versie van Adobe Commerce of Magento Open Source met de Braintree-extensie van de geïnstalleerde Commerce Marketplace, raadpleegt u de 2.4 opmerkingen bij upgrades aan het einde van deze pagina.

Stap 1: Krijg uw geloofsbrieven van de Braintree

Ga naar Braintreeën en meld u aan voor een account.

Stap 2: De basisinstellingen voltooien

  1. Op de Beheerder zijbalk, ga naar Stores > Settings>Configuration.

  2. Vouw in het linkerdeelvenster uit Sales en kiest u Payment Methods.

    • Als uw installatie van de Handel veelvoudige websites, opslag of meningen, in de hogere linkerhoek heeft, kies Store View waar de configuratie van toepassing is.

    • In de Merchant Location ​sectie, verifieer dat Merchant Country ​wordt ingesteld op de locatie van uw bedrijf.

  3. Onder Recommended Solutions ​in de_Braintree Payments (door GENE Commerce v4.6.1 - Opmerkingen bij de release_sectie, klikken Configure.

    Braintree configureren {width="600" modal="regular"}

  4. Voor Title, voert u een titel in die Braintree tijdens het afrekenen als betalingsoptie aanduidt.

  5. Huidige werking instellen Environment voor Braintree Sandbox of Production

    Gebruik bij het testen van de configuratie in een sandbox alleen creditcardnummers die door de Braintree worden aanbevolen. Wanneer u klaar bent om met Braintree naar de productie te gaan, stelt u Environment tot Production.

    Standaardinstellingen voor referenties {width="600" modal="regular"}

  6. Set Payment Action op een van de volgende wijzen:

    • Authorize Only - Goedkeuring van de aankoop en blokkering van de middelen. Het bedrag wordt pas van de bankrekening van de klant gehaald als de verkoop vastgelegd door de handelaar.|
    • Intent Sale - Het bedrag van de aankoop wordt toegestaan en onmiddellijk van de rekening van de klant teruggetrokken. Opmerking: Deze waarde is Autoriseren en vastleggen in 2.3.x en eerdere versies.|
  7. Voer de Sandbox Merchant ID / Merchant ID van uw Braintree account.

  8. Voer de volgende gegevens in vanaf uw Braintree-account:

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note note
    NOTE
    Er zijn verschillende velden voor beide (Sandbox en Production) omgevingen en de andere velden worden gerenderd op basis van de geselecteerde omgeving.
  9. Klik voordat u de configuratie opslaat op Validate Credentials om uw referenties te valideren.

  10. Set Enable Card Payments tot Yes.

    Basisinstellingen {width="600" modal="regular"}

    Als u de capaciteit wilt om klanteninformatie veilig op te slaan, zodat moeten de klanten niet het telkens opnieuw ingaan als zij een aankoop maken, plaatsen Enable Vault for Card Payments tot Yes.

Stap 3: De geavanceerde instellingen voltooien

  1. Uitbreiden Expansiekiezer de Advanced Braintree Settings sectie.

    Geavanceerde instellingen {width="550" modal="regular"}

  2. Voor Vault Title, voert u een beschrijvende titel voor uw referentie in die de vault identificeert waar de gegevens van uw klantenkaart zijn opgeslagen.

  3. Voer de Merchant Account ID van uw Braintree account.

    Als u niet de te gebruiken handelsrekening specificeert, verwerkt de Braintree de transactie gebruikend uw standaard handelaarrekening.

  4. Als je een snellere afhandeling wilt bieden met Express Payment Options aan het begin van het afhandelingsproces, zoals PayPal, PayPal, Apple Pay en Google Pay, moet je Enable Checkout Express Payments tot Yes.

  5. Als u wilt voorkomen dat de transactie ter evaluatie wordt verzonden als onderdeel van de geavanceerde controles van de Fraudegereedschappen, voor orders die via de beheerfunctie worden geplaatst, stelt u Skip Fraud Checks on Admin Orders tot Yes.

  6. Stel de Bypass Fraud Protection Threshold zodat de Advanced Fraud Protection controles worden overgeslagen wanneer de drempel wordt bereikt of overschreden.

    Als u dit veld leeg laat, wordt deze optie uitgeschakeld.

  7. Als u wilt dat het systeem een logbestand met interacties tussen de winkel en de Braintree opslaat, stelt u Debug tot Yes.

  8. Om klanten te verplichten de driecijferige veiligheidscode van de rug van een creditcard te verstrekken, reeks CVV Verification tot Yes.

    Bij gebruik van CVV-verificatie moet AVS en/of CVV in de Instellingen/verwerking van uw Braintree account.

  9. Als u de winkelwagentjes voor alle betalingsmethoden wilt verzenden, stelt u Send Card Line Items tot Yes.

  10. Voor Credit Card Types, selecteer elke creditcard die door je winkel wordt geaccepteerd als betaling via Braintree.

    Als u meerdere kaarttypen wilt selecteren, houdt u Ctrl (PC) of Command (Mac) ingedrukt en klikt u op elke optie.

  11. Voor Sort Order, voert u een getal in om de volgorde te bepalen waarin Braintree wordt weergegeven wanneer deze bij andere betalingsmethoden wordt aangeboden tijdens het afrekenen.

Stap 4: Voltooi de Braintree webhaakinstellingen

Instellingen Braintree webhooks

  1. Set Enable Webhook tot Yes de webhaakfunctionaliteit voor fraudebescherming, ACH-betalingen en lokale betalingsmethoden mogelijk te maken.

  2. Kopieer de URL in het dialoogvenster Fraud Protection URL en voeg het toe aan uw Braintree account als de Webhook Destination URL.

    note important
    IMPORTANT
    Deze URL moet veilig en openbaar toegankelijk zijn.
  3. Stel de Fraud Protection Approve Order Status vast te stellen wanneer de fraudebescherming door de Braintree wordt goedgekeurd.

    De geselecteerde orderstatus wordt toegewezen aan de handelsorder.

  4. Stel de Fraud Protection Reject Order Status vast te stellen wanneer fraudebescherming door de Braintree wordt verworpen.

    De geselecteerde orderstatus wordt toegewezen aan de handelsorder.

Stap 5: Vul de landspecifieke instellingen in

  1. Set Payment from Applicable Countries op een van de volgende wijzen:

    • All Allowed Countries - Klanten van iedereen landen Deze betalingsmethode kan worden gebruikt.
    • Specific Countries - Nadat u deze optie hebt gekozen, Payment from Specific Countries ​wordt weergegeven. Houd Ctrl (PC) of Command (Mac) ingedrukt en selecteer elk land in de lijst waar klanten aankopen kunnen doen in uw winkel.

    Landspecifieke instellingen {width="600" modal="regular"}

  2. Aan opstelling Country Specific Credit Card Types:

    • Klik op Add.

    • Stel de Country en kiest u elk Allowed Credit Card Type.

    • Herhaal dit om de creditcards te identificeren die vanuit elk land worden geaccepteerd.

Stap 6: Voltooi ACH door de montages van de Braintree

ACH door Braintree

  1. Als u ACH wilt opnemen als een betalingsoptie met Braintree, stelt u Enable ACH Direct Debit tot Yes.

  2. Klanten kunnen hun betalingsmethode voor automatische incasso voor eenmalig gebruik berekenen en deze opslaan voor toekomstig gebruik. Klanten kunnen na de vault ACH automatische incasso opnieuw gebruiken zonder dat ze hun betalingsgegevens opnieuw hoeven in te voeren of te verifiëren, indien deze zijn ingesteld Enable Vault for ACH Direct Debit tot Yes.

  3. Voor Sort Order, voert u een getal in om de volgorde te bepalen waarin de Braintree ACH-betalingsoptie wordt weergegeven wanneer deze bij andere betalingsopties wordt aangeboden tijdens het afrekenen.

Stap 7: Voltooi de Apple Pay via Braintree-instellingen

ApplePay via Braintree-instellingen

  1. Opnemen Apple Pay als een betalingsoptie met Braintree ingesteld Enable ApplePay through Braintree tot Yes.

    Zorg ervoor dat uw domeinnaam verifiëren eerst in uw Braintree account.

  2. Als u de mogelijkheid wilt hebben om klantgegevens veilig op te slaan, zodat klanten deze niet telkens opnieuw hoeven in te voeren wanneer ze een aankoop doen via Apple Pay, stelt u Enable Vault for ApplePay tot Yes.

  3. Set Payment Action op een van de volgende wijzen:

    • Authorize Only - Goedkeuring van de aankoop en blokkering van de middelen. Het bedrag wordt pas van de bankrekening van de klant gehaald als de verkoop vastgelegd door de handelaar.
    • Intent Sale - Het bedrag van de aankoop wordt toegestaan en onmiddellijk van de rekening van de klant teruggetrokken.
  4. Voor Merchant Name, voert u tekst in die het label opgeeft dat aan klanten wordt weergegeven in het dialoogvenster Apple Pay.

  5. Voor Sort Order voert u een getal in om de volgorde te bepalen waarin Apple Pay Er wordt een betalingsoptie weergegeven wanneer deze bij andere betalingsopties wordt aangeboden tijdens het afrekenen.

Stap 8: de instellingen voor lokale betalingsmethoden invullen

  1. Als u lokale betalingsmethoden wilt opnemen als betalingsoptie met Braintree, stelt u Enable Local Payment Methods tot Yes.

  2. Voor Title, voert u de tekst in die u wilt gebruiken voor het label dat wordt weergegeven in het gedeelte Betalingsmethode voor uitchecken (standaardwaarde): Local Payments).

  3. Voor Fallback Button Text, voert u de tekst in die u wilt gebruiken voor de knop die op de pagina voor de Braintree van de fallback wordt weergegeven, zodat de klant terug naar de website kan gaan (bijvoorbeeld Complete Checkout).

  4. Voor Redirect on Fail, voert u de URL in waar klanten moeten worden omgeleid wanneer transacties met lokale betalingsmethoden worden geannuleerd, mislukt of fouten optreden. Dit moet de betalingspagina voor afrekening zijn (bijvoorbeeld https://www.domain.com/checkout#payment).

  5. Voor Allowed Payment Methods, selecteert u de lokale betalingsmethode die moet worden ingeschakeld.

    Opties: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (nog niet ondersteund)

    Instellingen voor lokale betalingsmethoden {width="600" modal="regular"}

    note note
    NOTE
    De extensie van de gebundelde Braintree ondersteunt niet alle lokale betalingsmethoden die in de Braintree ontwikkelaarsdocumentatie. Andere lokale betalingsmethoden worden momenteel ontwikkeld en zullen in toekomstige versies worden ondersteund.
  6. Voor Sort Order Voer een getal in om de volgorde te bepalen waarin de lokale betalingsmethode wordt weergegeven wanneer deze bij andere betalingsopties wordt aangeboden tijdens het afrekenen.

Stap 9: Voltooi de Google Pay via Braintree-instellingen

Google betalen via Braintree

  1. Opnemen Google Pay als een betalingsoptie met Braintree ingesteld Enable GooglePay Through Braintree tot Yes.

  2. Als u de mogelijkheid wilt hebben om klantgegevens veilig op te slaan, zodat klanten deze niet telkens opnieuw hoeven in te voeren wanneer ze een aankoop doen via Google Pay, stelt u Enable Vault for GooglePay tot Yes.

  3. Set Payment Action op een van de volgende wijzen:

    • Authorize Only - Goedkeuring van de aankoop en blokkering van de middelen. Het bedrag wordt pas van de bankrekening van de klant gehaald als de verkoop vastgelegd door de handelaar.
    • Intent Sale - Het bedrag van de aankoop wordt toegestaan en onmiddellijk van de rekening van de klant teruggetrokken.
  4. Set Button Color om de kleur van Google Pay knop: White of Black

  5. Voor Merchant ID, voer je MerchantID in (opgegeven door Google).

  6. Voor Accepted Cards selecteert u het type kaart dat een klant kan gebruiken om een bestelling te plaatsen met Google Pay.

    Opties: Visa / MasterCard / AMEX / Discover / JCB

  7. Voor Sort Order voert u een getal in om de volgorde te bepalen waarin Google Pay wordt weergegeven wanneer deze bij andere betalingsopties wordt aangeboden tijdens het afrekenen.

Stap 10: Vul de Venmo-instellingen in via de Braintree

  1. Als u Venmo wilt opnemen als betalingsoptie met Braintree, stelt u Enable Venmo through Braintree tot Yes.

  2. Set Enable Vault for Venmo tot Yes om het gebruik van een beveiligde kluis mogelijk te maken voor het opslaan van de Venmo-account van klanten, zodat de klant zich niet opnieuw hoeft aan te melden bij zijn Venmo-account voor toekomstige transacties.

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

  3. Set Payment Action op een van de volgende wijzen:

    • Authorize Only - Goedkeuring van de aankoop en blokkering van de middelen. Het bedrag wordt pas van de bankrekening van de klant gehaald als de verkoop vastgelegd door de handelaar.
    • Intent Sale - Het bedrag van de aankoop wordt toegestaan en onmiddellijk van de rekening van de klant teruggetrokken.
  4. Voor Sort Order, voert u een getal in om de volgorde te bepalen waarin Venmo wordt weergegeven bij andere betalingsopties tijdens het afrekenen.

Stap 11: Voltooi de PayPal-Braintree-instellingen

PayPal via Braintree-instellingen

  1. Als u PayPal wilt opnemen als betalingsoptie met Braintree, stelt u Enable PayPal through Braintree tot Yes.

  2. Geef je PayPal-rekening op via de betalingsmethode voor Braintreeën:

    note note
    NOTE
    Willekeurig PayPal Credit of PayPal PayLater kan worden ingeschakeld. Beide methoden kunnen niet tegelijkertijd worden ingeschakeld.
    • Opnemen PayPal Credit als een betalingsoptie met Braintree ingesteld Enable PayPal Credit through Braintree tot Yes.

      Wanneer PayPal inschakelen via Braintree is ingesteld op Yeswordt alleen dit veld weergegeven.

      note note
      NOTE
      PayPal-krediet is alleen beschikbaar in de Verenigde Staten en het Verenigd Koninkrijk. PayPal-krediet is uitgeschakeld als de geselecteerde waarde voor de Merchant Country ​veld is niet US of UK.
    • Opnemen PayPal PayLater als een betalingsoptie met Braintree ingesteld Enable PayPal PayLater through Braintree tot Yes.

      Wanneer Enable PayPal PayLater through Braintree is ingesteld op Yeswordt alleen dit veld weergegeven.

      Je kunt PayPal-berichten op je site weergeven voor aanbiedingen, zoals Betalen in 3, waardoor klanten met drie rentevrije maandelijkse betalingen kunnen betalen. De Braintree-integratie kan berichten op uw site weergeven om deze functie te promoten. Je kunt PayPal-aanbiedingen niet promoten met andere inhoud, marketing of materialen.

  3. Voor Title, voer een titel in die de Braintree aangeeft die via PayPal is betaald tijdens het afrekenen.

  4. Set Vault Enabled tot Yes om het gebruik van een beveiligde kluis in te schakelen voor het opslaan van het PayPal-account van klanten. U kunt een Vaulted PayPal-account gebruiken voor toekomstige transacties, waardoor het aantal stappen voor klanten afneemt.

  5. Set Send Cart Line Items for PayPal tot Yes om de regelobjecten (bestelling) samen met creditcards naar PayPal te sturen, cadeau voor objecten, Gift Wrapping voor bestelling, Winkelkrediet, Verzending en Belasting als lijnobjecten.

  6. Voor Sort Order, voert u een getal in om de volgorde te bepalen waarin de Braintree PayPal-betalingsoptie wordt weergegeven wanneer deze bij andere betalingsopties wordt aangeboden tijdens het afrekenen.

  7. De handelsnaam anders weergeven dan de naam die in uw winkelconfiguratie, voert u de naam in in het dialoogvenster Override Merchant Name in het veld dat u wilt weergeven.

  8. Set Payment Action op een van de volgende wijzen:

    • Authorize Only - Goedkeuring van de aankoop en blokkering van de middelen. Het bedrag wordt pas van de bankrekening van de klant gehaald als de verkoop vastgelegd door de handelaar.
    • Authorize and Capture - Het bedrag van de aankoop wordt toegestaan en onmiddellijk van de rekening van de klant teruggetrokken.
  9. Set Payment from Applicable Countries naar een van de volgende opties voor door PayPal verwerkte Braintreeën:

    • All Allowed Countries - Klanten van iedereen landen Deze betalingsmethode kan worden gebruikt.
    • Specific Countries - Nadat u deze optie hebt gekozen, Payment from Specific Countries ​wordt weergegeven. Houd Ctrl (PC) of Command (Mac) ingedrukt en selecteer elk land in de lijst waar klanten aankopen kunnen doen in uw winkel.
  10. Om klanten te vereisen om een het facturerings adres te verstrekken, plaats Require Customer’s Billing Address tot Yes.

    note note
    NOTE
    Deze functie moet voor uw account zijn ingeschakeld door de technische ondersteuning van PayPal.
  11. Als u een logbestand met interacties tussen uw winkel en PayPal wilt opslaan via Braintree, stelt u Debug tot Yes.

  12. Als u de PayPal-knop wilt weergeven op de pagina met de mini-winkelwagentje en de winkelwagentje, stelt u Display on Shopping Cart tot Yes.

Stap 12: De stijlinstellingen instellen

  1. Voor Location, kies waar PayPal-knoppen en -berichten worden weergegeven: Mini-Cart and Cart Page, Checkout Page, of Product Page

    Instellingen voor PayPal-stijlen {width="600" modal="regular"}

Mini-Cart and Cart Page

De opties en instellingen in deze sectie variëren afhankelijk van de instelling in het dialoogvenster Location ​veld.

  1. Set PayPal Button Type tot één van drie soorten knopen: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

De opties en instellingen in deze sectie variëren afhankelijk van het knoptype dat u in het dialoogvenster PayPal Button Type ​veld.

  1. Als u de PayPal-knop op de winkel op de geselecteerde locatie wilt weergeven, stelt u Show PayPal Button tot Yes.

  2. Voor Button Label, selecteert u het PayPal-knoplabel: Paypal, Checkout, Buynow, of Pay

  3. Voor Color, selecteert u de PayPal-knopkleur: Blue, Black, Gold, of Silver

  4. Voor Shape Selecteer de vorm van de PayPal-knop: Pill of Rectangle

  5. Voor Size (Deprecated), selecteert u de PayPal-knopgrootte: Medium, Large, of Responsive

NOTE
De Size(Deprecated) Het configuratieveld is vervangen en wordt niet gebruikt om de PayPal-knoppen op te maken.

PayLater Messaging

  1. Weergeven PayLater berichten op de storefront bij de geselecteerde plaats, reeks Show PayLater Messaging tot Yes.

    Dit bericht bevat de weergave van PayLater berichten voor beschikbare voorstellen (beperkingen gelden).

  2. Voor Message Layout, selecteert u de PayLater berichtindeling: Text of Flex

  3. Voor Logo, selecteert u het type PayPal-logo: Inline, Primary, Alternative, of None

  4. Voor Logo Position, selecteert u de positie van het PayPal-logo: Left, Right, of Top

  5. Voor Text Color, selecteert u de PayLater kleur berichttekst: Black, White, Monochrome, of Grayscale

Wanneer deze opties zijn ingesteld, kunt u een voorvertoning van de PayPal-knoppen en PayPal-berichten zien. U kunt de instellingen toepassen of de waarden opnieuw instellen met behulp van de volgende besturingselementen:

  • Als u de geselecteerde opmaakinstellingen voor knoppen en PayLater-berichten wilt opslaan en deze op de huidige locatie en het huidige knoptype wilt toepassen, klikt u op Apply.

  • als u de geselecteerde opmaakinstellingen voor knoppen en berichtwaarden voor PayPal wilt opslaan en deze wilt toepassen op alle knoptypen en -locaties, klikt u op Apply to All Buttons.

  • Als u de opmaakinstellingen wilt terugzetten op de aanbevolen standaardwaarden voor knoppen en PayLater-berichten en deze wilt toepassen op alle knoptypen en -locaties, klikt u op Reset to Recommended Defaults.

Stap 13: De instellingen voor 3D-verificatie voltooien

  1. Als u een verificatiestap wilt toevoegen voor klanten die creditcards gebruiken die zijn ingeschreven voor een verificatieprogramma (zoals Gecontroleerd door VISA), set 3D Secure Verification tot Yes.

    Tijdens het proces wordt het transactiebedrag dat ter controle wordt voorgelegd gecontroleerd tegen het bedrag dat voor goedkeuring wordt verzonden.

  2. Om het 3D Veilige verzoek voor alle transacties altijd aan te vechten, reeks Always request 3DS tot Yes.

  3. Voor Threshold Amount Voer het minimale orderbedrag in dat vereist is om 3D-verificatie te starten.

  4. Set Verify for Applicable Countries op een van de volgende wijzen:

    • All Allowed Countries - Klanten van iedereen landen Deze betalingsmethode kan worden gebruikt.
    • Specific Countries - Nadat u deze optie hebt gekozen, Verify for Specific Countries ​wordt weergegeven. Houd Ctrl (PC) of Command (Mac) ingedrukt en selecteer elk land in de lijst waar klanten aankopen kunnen doen in uw winkel.

    Instellingen voor 3D-verificatie {width="600" modal="regular"}

Stap 14: Opstelling de dynamische beschrijvers van de Braintree

De volgende beschrijvingen worden gebruikt om aankopen te identificeren op creditcardoverzichten van klanten. U kunt het aantal terugbetalingen verminderen door duidelijk het bedrijf te identificeren dat met elke aankoop wordt geassocieerd. Als dynamische beschrijvingen niet zijn ingeschakeld voor uw account, neemt u contact op met de ondersteuning van Braintreeën.

Dynamische beschrijvingen

  1. Voer de dynamische descriptor in voor de Name, Phone, en URL volgens deze richtsnoeren :

    • Name - De naamdescriptor bestaat uit twee delen, die worden gescheiden door een asterisk (*). Bijvoorbeeld:

      company*myproduct

      Het eerste deel van de descriptor identificeert het bedrijf of de DBA en het tweede deel identificeert het product. De lengte van de company en product delen van de descriptor kunnen op de volgende manieren worden toegewezen, voor een gecombineerde lengte van maximaal 22 tekens.

      Tekens in naamdescriptor

      Optie 1: Company moet uit drie tekens bestaan; Product mag maximaal 18 tekens bevatten

      Optie 2: Company moet uit zeven tekens bestaan; Product mag maximaal 14 tekens bevatten

      Optie 3: Company moet uit 12 tekens bestaan, Product mag maximaal negen tekens bevatten

    • Phone - De telefoondescriptor moet 10 tot 14 tekens lang zijn en mag alleen cijfers, streepjes, haakjes en punten bevatten. Bijvoorbeeld:

      9999999999

      (999) 999-9999

      999.999.9999

    • URL - De URL-descriptor vertegenwoordigt uw domeinnaam en kan maximaal 13 tekens lang zijn. Bijvoorbeeld:

      company.com

  2. Wanneer uw configuratie van de Braintree volledig is, klik Save Config.

2.4 opmerkingen bij upgrades

Vanaf Adobe Commerce en Magento Open Source 2.4.0 is de extensie Braintree opgenomen in de release. Als u naar Handel 2.4.x van een versie pre 2.4.0 migreert die de uitbreiding van de Braintree van de Marketplace heeft geïnstalleerd, moet u die uitbreiding verwijderen (paypal/module-braintree of gene/module-braintree) en eventuele codeaanpassingen bijwerken om de PayPal_Braintree naamruimte in plaats van Magento_Braintree. De montages van de configuratie van de kernBetalingen van de Braintree van de Handel gebundelde uitbreiding en de uitbreiding die op Commerce Marketplace wordt verdeeld blijven bestaan en de betalingen die met die vorige versies worden geplaatst kunnen nog worden gevangen, ongeldig worden verklaard, of worden teruggegeven als normaal.

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