Braintree

Braintree offre un’esperienza di pagamento completamente personalizzabile con rilevamento di frodi e integrazione PayPal. Supporta Apple Pay, Google Pay, ACH, Venmo e metodi di pagamento locali. Braintree riduce il carico di conformità PCI per gli esercenti perché la transazione avviene sul sistema Braintree. L'integrazione Braintree Payments è sviluppata da Gene Commerce.

NOTE
Se esegui l’aggiornamento a 2.4.x da una versione precedente di Adobe Commerce o di un Magento Open Source con l’estensione Braintree di Commerci Marketplace installata, consulta la sezione Note sull’aggiornamento 2.4 alla fine di questa pagina.

Passaggio 1: ottieni le credenziali Braintree

Vai a Braintree pagamenti e registratevi per un account.

Passaggio 2: completare le impostazioni di base

  1. Il giorno Amministratore barra laterale, vai a Stores > Settings>Configuration.

  2. Nel pannello a sinistra, espandi Sales e scegli Payment Methods.

    • Se nell’installazione di Commerce sono presenti più siti web, store o visualizzazioni, nell’angolo in alto a sinistra, scegli Store View dove si applica la configurazione.

    • In Merchant Location, verifica che Merchant Country ​è impostato sulla posizione dell’azienda.

  3. Sotto Recommended Solutions, nella_Braintree Payments (di Gene Commerce v4.6.1 - Note sulla versione_, fare clic su Configure.

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

  4. Per Title, immettere un titolo che identifichi Braintree come opzione di pagamento durante il pagamento.

  5. Imposta il valore operativo corrente Environment per Braintree transazioni a Sandbox o Production

    Quando esegui il test della configurazione in una sandbox, utilizza solo numeri di carta di credito che sono consigliati dalla Braintree. Quando si è pronti per passare alla produzione con Braintree, impostare Environment a Production.

    Impostazioni credenziali di base {width="600" modal="regular"}

  6. Imposta Payment Action a uno dei seguenti elementi:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino alla vendita acquisito dal commerciante.|
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente prelevato dal conto del cliente. Nota: Questo valore era Autorizza e acquisisci nella versione 2.3.x e nelle versioni precedenti.|
  7. Inserisci il Sandbox Merchant ID / Merchant ID dal tuo account Braintree.

  8. Immetti le seguenti credenziali dal tuo account di Braintree:

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note note
    NOTE
    Sono presenti campi separati per entrambi (Sandbox e produzione) e gli altri campi vengono riprodotti in base all’ambiente selezionato.
  9. Prima di salvare la configurazione, fai clic su Validate Credentials per convalidare le credenziali.

  10. Imposta Enable Card Payments a Yes.

    Impostazioni di base {width="600" modal="regular"}

    Se desideri che le informazioni sui clienti vengano memorizzate in modo sicuro, in modo che i clienti non debbano reinserirle ogni volta che effettuano un acquisto, imposta Enable Vault for Card Payments a Yes.

Passaggio 3: completare le impostazioni avanzate

  1. Espandi Selettore di espansione il Advanced Braintree Settings sezione.

    Impostazioni avanzate {width="550" modal="regular"}

  2. Per Vault Title, inserisci un titolo descrittivo per il riferimento che identifichi l'archivio in cui sono memorizzate le informazioni sulla carta del cliente.

  3. Inserisci il Merchant Account ID dal tuo account Braintree.

    Se non si specifica il conto esercente da utilizzare, Braintree elabora la transazione utilizzando il proprio conto esercente predefinito.

  4. Per offrire un'esperienza di pagamento più rapida con le opzioni di pagamento rapido all'inizio del processo di pagamento, tra cui PayPal, PayLater, Apple Pay e Google Pay, impostare Enable Checkout Express Payments a Yes.

  5. Se si desidera impedire che la transazione venga inviata per la valutazione come parte dei controlli degli strumenti di frode avanzati, per gli ordini inoltrati tramite l'amministratore, impostare Skip Fraud Checks on Admin Orders a Yes.

  6. Imposta il Bypass Fraud Protection Threshold in modo che Advanced Fraud Protection i controlli vengono ignorati quando la soglia viene raggiunta o superata.

    Se si lascia vuoto questo campo, questa opzione viene disabilitata.

  7. Se si desidera che venga salvato un file di registro delle interazioni tra l'archivio e la Braintree, impostare Debug a Yes.

  8. Per richiedere ai clienti di fornire il codice di sicurezza a tre cifre dal retro di una carta di credito, impostare CVV Verification a Yes.

    Se utilizzi la verifica CVV, assicurati di abilitare AVS e/o CVV in Impostazioni/Elaborazione del tuo account di Braintree.

  9. Per inviare le voci del carrello per tutti i metodi di pagamento, impostare Send Card Line Items a Yes.

  10. Per Credit Card Types, seleziona ogni carta di credito accettata dal tuo Negozio come pagamento tramite Braintree.

    Per selezionare più tipi di schede, tenere premuto il tasto Ctrl (PC) o il tasto Comando (Mac) e fare clic su ciascuna opzione.

  11. Per Sort Order, immettere un numero per determinare la sequenza in cui viene visualizzata la Braintree quando viene elencata con altri metodi di pagamento durante il pagamento.

Passaggio 4: completare le impostazioni del webhook di Braintree

Braintree impostazioni webhook {width="600" modal="regular"}

  1. Imposta Enable Webhook a Yes abilitare la funzionalità webhook per la protezione dalle frodi, i pagamenti ACH e i metodi di pagamento locali.

  2. Copia l’URL in Fraud Protection URL e aggiungerlo al tuo account di Braintree come Webhook Destination URL.

    note important
    IMPORTANT
    Questo URL deve essere sicuro e accessibile al pubblico.
  3. Imposta il Fraud Protection Approve Order Status per determinare quando la protezione contro le frodi è approvata dalla Braintree.

    Lo stato dell’ordine selezionato viene assegnato all’ordine Commerce.

  4. Imposta il Fraud Protection Reject Order Status campo per determinare quando la protezione dalle frodi è rifiutata dalla Braintree.

    Lo stato dell’ordine selezionato viene assegnato all’ordine Commerce.

Passaggio 5: completare le impostazioni specifiche del paese

  1. Imposta Payment from Applicable Countries a uno dei seguenti elementi:

    • All Allowed Countries - Clienti di tutti paesi specificato nella configurazione del negozio può utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, il Payment from Specific Countries ​viene visualizzato. Tenere premuto il tasto Ctrl (PC) o il tasto Comando (Mac) e selezionare ogni paese nell'elenco in cui i clienti possono effettuare acquisti dal negozio.

    Impostazioni specifiche per paese {width="600" modal="regular"}

  2. Per impostare Country Specific Credit Card Types:

    • Clic Add.

    • Imposta il Country e scegliete ciascuno Allowed Credit Card Type.

    • Ripetere l'operazione per identificare le carte di credito accettate da ciascun paese.

Passaggio 6: completare l'ACH tramite le impostazioni delle Braintree

BRAINTREE ACH-through {width="600" modal="regular"}

  1. Per includere ACH come opzione di pagamento con Braintree, impostare Enable ACH Direct Debit a Yes.

  2. I clienti possono archiviare il metodo di pagamento con Addebito automatico sul conto bancario (ACH Direct Debit) monouso e memorizzarlo per utilizzarlo in futuro. Una volta effettuato il vaulting, i clienti possono riutilizzare l'addebito diretto ACH senza dover reinserire o autenticare le informazioni di pagamento se impostate Enable Vault for ACH Direct Debit a Yes.

  3. Per Sort Order Inserire un numero per determinare la sequenza in cui viene visualizzata l'opzione di pagamento Braintree ACH quando elencata con altre opzioni di pagamento durante l'estrazione.

Passaggio 7: completare Apple Pay tramite impostazioni Braintree

Impostazioni di ApplePay tramite Braintree {width="600" modal="regular"}

  1. Da includere Apple Pay come opzione di pagamento con Braintree, imposta Enable ApplePay through Braintree a Yes.

    Assicurati di verificare il nome di dominio nel tuo account di Braintree.

  2. Se desideri poter archiviare le informazioni dei clienti in modo sicuro, in modo che i clienti non debbano reinserirle ogni volta che effettuano un acquisto con Apple Pay, imposta Enable Vault for ApplePay a Yes.

  3. Imposta Payment Action a uno dei seguenti elementi:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino alla vendita acquisito dal mercante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente prelevato dal conto del cliente.
  4. Per Merchant Name, immetti il testo che specifica l’etichetta visualizzata ai clienti nella finestra di dialogo Apple Pay.

  5. Per Sort Order immettere un numero per determinare la sequenza in cui Apple Pay l'opzione di pagamento viene visualizzata quando è elencato con altre opzioni di pagamento durante l'estrazione.

Passo 8: Completare le impostazioni per i metodi di pagamento locali

  1. Per includere i metodi di pagamento locali come opzione di pagamento con Braintree, impostare Enable Local Payment Methods a Yes.

  2. Per Title, immettere il testo da utilizzare per l'etichetta visualizzata nella sezione relativa al metodo di pagamento del pagamento di pagamento (valore predefinito: Local Payments).

  3. Per Fallback Button Text, immetti il testo da utilizzare per il pulsante visualizzato nella pagina della Braintree di fallback per reindirizzare il cliente al sito web (ad esempio, Complete Checkout).

  4. Per Redirect on Fail, immettere l'URL in cui i clienti devono essere reindirizzati quando le transazioni del metodo di pagamento locale vengono annullate, non riuscite o rilevano errori. Deve essere la pagina di pagamento per l’estrazione (ad esempio, https://www.domain.com/checkout#payment).

  5. Per Allowed Payment Methods, selezionare il metodo di pagamento locale da abilitare.

    Opzioni: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (non ancora supportato)

    Impostazioni dei metodi di pagamento locali {width="600" modal="regular"}

    note note
    NOTE
    L'estensione di Braintree in bundle non supporta tutti i metodi di pagamento locali elencati nel Braintree documentazione per sviluppatori. Sono in fase di sviluppo altri metodi di pagamento locali, che saranno supportati nelle prossime versioni.
  6. Per Sort Order Immettere un numero per determinare la sequenza in cui viene visualizzato il metodo di pagamento locale quando viene elencato con altre opzioni di pagamento durante il pagamento.

Passaggio 9: completare Google Pay tramite impostazioni Braintree

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

  1. Da includere Google Pay come opzione di pagamento con Braintree, imposta Enable GooglePay Through Braintree a Yes.

  2. Se desideri poter archiviare le informazioni dei clienti in modo sicuro, in modo che i clienti non debbano reinserirle ogni volta che effettuano un acquisto con Google Pay, imposta Enable Vault for GooglePay a Yes.

  3. Imposta Payment Action a uno dei seguenti elementi:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino alla vendita acquisito dal mercante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente prelevato dal conto del cliente.
  4. Imposta Button Color per determinare il colore del Google Pay pulsante: White o Black

  5. Per Merchant ID, immetti l'ID commerciante (fornito da Google).

  6. Per Accepted Cards, seleziona il tipo di schede utilizzabili da un cliente per effettuare un ordine utilizzando Google Pay.

    Opzioni: Visa / MasterCard / AMEX / Discover / JCB

  7. Per Sort Order immettere un numero per determinare la sequenza in cui Google Pay viene visualizzato quando viene elencato con altre opzioni di pagamento durante l'estrazione.

Passaggio 10: Completare le impostazioni di Braintree di Venmo through

  1. Per includere Venmo come opzione di pagamento con Braintree, impostare Enable Venmo through Braintree a Yes.

  2. Imposta Enable Vault for Venmo a Yes per consentire l'utilizzo di un vaulting sicuro per archiviare l'account Venmo dei clienti in modo che non sia necessario accedere nuovamente al loro account Venmo per le transazioni future.

    Venmo attraverso la Braintree {width="600" modal="regular"}

  3. Imposta Payment Action a uno dei seguenti elementi:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino alla vendita acquisito dal mercante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente prelevato dal conto del cliente.
  4. Per Sort Order, immettere un numero per determinare la sequenza in cui viene visualizzato Venmo quando viene elencato con altre opzioni di pagamento durante il pagamento.

Passo 11: Completare PayPal attraverso le impostazioni di Braintree

PayPal tramite impostazioni Braintree {width="550" modal="regular"}

  1. Per includere PayPal come opzione di pagamento con Braintree, impostare Enable PayPal through Braintree a Yes.

  2. Specifica il metodo di pagamento PayPal tramite Braintree:

    note note
    NOTE
    o PayPal Credit o PayPal PayLater possono essere abilitati. Entrambi i metodi non possono essere attivati contemporaneamente.
    • Da includere PayPal Credit come opzione di pagamento con Braintree, imposta Enable PayPal Credit through Braintree a Yes.

      Quando Abilita PayPal tramite Braintree è impostato su Yes, viene visualizzato solo questo campo.

      note note
      NOTE
      PayPal Credit è disponibile solo negli Stati Uniti e nel Regno Unito. Il credito PayPal è disabilitato se il valore selezionato per Merchant Country ​il campo non è US o UK.
    • Da includere PayPal PayLater come opzione di pagamento con Braintree, imposta Enable PayPal PayLater through Braintree a Yes.

      Quando Enable PayPal PayLater through Braintree è impostato su Yes, viene visualizzato solo questo campo.

      Puoi visualizzare i messaggi PayLater sul tuo sito per le offerte, ad esempio Pagamento in 3, che consente ai clienti di pagare con tre pagamenti mensili senza interessi. L’integrazione Braintree può visualizzare messaggi sul sito per promuovere questa funzione. Non puoi promuovere le offerte PayLater con altri contenuti, materiale di marketing o materiale.

  3. Per Title, inserisci un titolo che identifichi l'opzione Braintree pagamento tramite PayPal durante il pagamento.

  4. Imposta Vault Enabled a Yes per abilitare l'utilizzo di un vaulting sicuro per archiviare il conto PayPal dei clienti. Il conto PayPal archiviato può essere utilizzato per transazioni future, riducendo il numero di passaggi per i clienti.

  5. Imposta Send Cart Line Items for PayPal a Yes per inviare gli articoli in linea (articoli dell'ordine) a PayPal insieme a Biglietti regalo, Confezione regalo per gli articoli, Confezione regalo per l'ordine, Credito del negozio, Spedizione e Imposta come articoli in linea.

  6. Per Sort Order, immettere un numero per determinare la sequenza in cui viene visualizzata l'opzione Braintree pagamento PayPal quando elencata con altre opzioni di pagamento durante il pagamento.

  7. Per visualizzare il nome dell'esercente in modo diverso rispetto a quanto definito nel configurazione archivio, immetti il nome in Override Merchant Name come si desidera che venga visualizzato.

  8. Imposta Payment Action a uno dei seguenti elementi:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino alla vendita acquisito dal mercante.
    • Authorize and Capture - L'importo dell'acquisto è autorizzato e immediatamente prelevato dal conto del cliente.
  9. Imposta Payment from Applicable Countries per le transazioni Braintree elaborate da PayPal:

    • All Allowed Countries - Clienti di tutti paesi specificato nella configurazione del negozio può utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, il Payment from Specific Countries ​viene visualizzato. Tenere premuto il tasto Ctrl (PC) o il tasto Comando (Mac) e selezionare ogni paese nell'elenco in cui i clienti possono effettuare acquisti dal negozio.
  10. Per richiedere ai clienti di fornire un indirizzo di fatturazione, impostare Require Customer’s Billing Address a Yes.

    note note
    NOTE
    Questa funzione deve essere abilitata per il tuo account dal Supporto tecnico PayPal.
  11. Per salvare un file di registro delle interazioni tra il tuo store e PayPal tramite Braintree, imposta Debug a Yes.

  12. Per visualizzare il pulsante PayPal sia sul mini carrello che sulla pagina del carrello, imposta Display on Shopping Cart a Yes.

Passaggio 12: impostazione degli stili

  1. Per Location, scegli dove vengono riprodotti i pulsanti e i messaggi PayPal: Mini-Cart and Cart Page, Checkout Page, o Product Page

    Impostazioni stile PayPal {width="600" modal="regular"}

Mini-Cart and Cart Page

Le opzioni e le impostazioni di questa sezione variano a seconda dell'impostazione nella Location ​campo.

  1. Imposta PayPal Button Type a uno dei tre tipi di pulsanti: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

Le opzioni e le impostazioni di questa sezione variano a seconda del tipo di pulsante selezionato nella PayPal Button Type ​campo.

  1. Per visualizzare il pulsante PayPal sulla vetrina nella posizione selezionata, impostare Show PayPal Button a Yes.

  2. Per Button Label, selezionare l'etichetta del pulsante PayPal: Paypal, Checkout, Buynow, o Pay

  3. Per Color, selezionare il colore del pulsante PayPal: Blue, Black, Gold, o Silver

  4. Per Shape, selezionare la forma pulsante PayPal: Pill o Rectangle

  5. Per Size (Deprecated), selezionare la dimensione del pulsante PayPal: Medium, Large, o Responsive

NOTE
Il Size(Deprecated) Il campo di configurazione è obsoleto e non viene utilizzato per assegnare uno stile ai pulsanti PayPal.

PayLater Messaging

  1. Da mostrare PayLater messaggi nella vetrina nella posizione selezionata, impostare Show PayLater Messaging a Yes.

    Questo messaggio include la visualizzazione di PayLater messaggistica per le offerte disponibili (restrizioni applicate).

  2. Per Message Layout, seleziona la PayLater layout messaggio: Text o Flex

  3. Per Logo, seleziona il tipo di logo PayPal: Inline, Primary, Alternative, o None

  4. Per Logo Position, seleziona la posizione del logo PayPal: Left, Right, o Top

  5. Per Text Color, seleziona la PayLater colore testo messaggio: Black, White, Monochrome, o Grayscale

Quando queste opzioni sono impostate, puoi visualizzare l'anteprima dei pulsanti PayPal e dei messaggi PayLater. Esistono controlli che è possibile utilizzare per applicare le impostazioni o reimpostare i valori:

  • Per memorizzare le impostazioni di stile selezionate per i pulsanti e i messaggi PayLater e applicarle alla posizione corrente e al tipo di pulsante corrente, fare clic su Apply.

  • per memorizzare le impostazioni di stile selezionate per i pulsanti e i valori di messaggistica PayLater e applicarle a tutti i tipi di pulsanti e le posizioni, fare clic su Apply to All Buttons.

  • Per ripristinare i valori predefiniti consigliati per i pulsanti e i messaggi PayLater e applicarli a tutti i tipi di pulsanti e a tutte le posizioni, fare clic su Reset to Recommended Defaults.

Passaggio 13: completare le impostazioni di verifica 3D

  1. Se si desidera aggiungere una fase di verifica per i clienti che utilizzano carte di credito registrate in un programma di verifica, ad esempio Verificato da VISA), imposta 3D Secure Verification a Yes.

    Durante il processo, l'importo della transazione sottomesso per la verifica viene confrontato con l'importo inviato per l'autorizzazione.

  2. Per contestare sempre la richiesta 3D Secure per tutte le transazioni, impostare Always request 3DS a Yes.

  3. Per Threshold Amount, immettere l'importo minimo dell'ordine necessario per attivare la verifica 3D.

  4. Imposta Verify for Applicable Countries a uno dei seguenti elementi:

    • All Allowed Countries - Clienti di tutti paesi specificato nella configurazione del negozio può utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, il Verify for Specific Countries ​viene visualizzato. Tenere premuto il tasto Ctrl (PC) o il tasto Comando (Mac) e selezionare ogni paese nell'elenco in cui i clienti possono effettuare acquisti dal negozio.

    Impostazioni di verifica 3D {width="600" modal="regular"}

Passaggio 14: configurare i descrittori dinamici Braintree

I seguenti descrittori vengono utilizzati per identificare gli acquisti sugli estratti conto della carta di credito del cliente. Puoi ridurre il numero di chargeback identificando chiaramente l’azienda associata a ogni acquisto. Se i descrittori dinamici non sono abilitati per il tuo account, contatta il supporto Braintree.

Descrittori dinamici {width="600" modal="regular"}

  1. Inserisci il descrittore dinamico per Name, Phone, e URL secondo le presenti linee guida:

    • Name - Il descrittore del nome è composto da due parti, separate da un asterisco (*). Ad esempio:

      company*myproduct

      La prima parte del descrittore identifica l’azienda o il DBA e la seconda parte identifica il prodotto. La lunghezza del company e product parti del descrittore possono essere allocate nei modi seguenti, per una lunghezza combinata fino a 22 caratteri.

      Caratteri nel descrittore del nome

      Opzione 1: Company deve contenere tre caratteri, Product può contenere fino a 18 caratteri

      Opzione 2: Company deve essere di sette caratteri, Product può contenere fino a 14 caratteri

      Opzione 3: Company deve essere di 12 caratteri, Product può contenere fino a nove caratteri

    • Phone - Il descrittore telefonico deve contenere tra 10 e 14 caratteri e può includere solo numeri, trattini, parentesi e punti. Ad esempio:

      9999999999

      (999) 999-9999

      999.999.9999

    • URL : il descrittore URL rappresenta il nome di dominio e può contenere fino a 13 caratteri. Ad esempio:

      company.com

  2. Al termine della configurazione di Braintree, fai clic su Save Config.

Note sull’aggiornamento 2.4

A partire da Adobe Commerce e dal Magento Open Source 2.4.0, l’estensione Braintree è inclusa nella versione. Se stai eseguendo la migrazione a Commerce 2.4.x da una versione precedente alla 2.4.0 in cui è installata l’estensione Marketplace Braintree, devi disinstallare tale estensione (paypal/module-braintree o gene/module-braintree) e aggiorna tutte le personalizzazioni del codice per utilizzare PayPal_Braintree spazio dei nomi anziché Magento_Braintree. Le impostazioni di configurazione dell’estensione bundle Commerce Braintree Payments di base e l’estensione distribuita su Commerci Marketplace persistono e i pagamenti effettuati con le versioni precedenti possono ancora essere acquisiti, annullati o rimborsati come di consueto.

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