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 è stata sviluppata da GENE Commerce.

NOTE
Se stai eseguendo l'aggiornamento a 2.4.x da una versione precedente di Adobe Commerce o di un Magento Open Source con l'estensione Braintree di Commerce Marketplace installata, consulta le 2.4 note sull'aggiornamento alla fine di questa pagina.

Passaggio 1: ottieni le credenziali Braintree

Vai a Braintree pagamenti e registrati per un account.

Passaggio 2: completare le impostazioni di base

  1. Nella barra laterale Admin, passa 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 superiore sinistro scegliere Store View in cui applicare la configurazione.

    • Nella sezione Merchant Location ​verificare che Merchant Country ​sia impostato sul percorso dell'azienda.

  3. In Recommended Solutions, nella sezione_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 l'estrazione.

  5. Imposta Environment operativo corrente per le transazioni Braintree su Sandbox o Production

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

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

  6. Imposta Payment Action su uno dei seguenti:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente fino a quando la vendita non viene acquisita dall'esercente.|
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente ritirato dal conto del cliente. Nota: questo valore era Autorizza e acquisisci nelle versioni 2.3.x e precedenti.|
  7. Immetti Sandbox Merchant ID / Merchant ID dal tuo account di 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 gli ambienti (Sandbox e Produzione) e per gli altri campi il rendering dipende dall'ambiente selezionato.
  9. Prima di salvare la configurazione, fare clic su Validate Credentials per convalidare le credenziali.

  10. Imposta Enable Card Payments su Yes.

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

    Se si desidera poter archiviare le informazioni dei clienti in modo sicuro, in modo che i clienti non debbano reinserirle ogni volta che effettuano un acquisto, impostare Enable Vault for Card Payments su Yes.

Passaggio 3: completare le impostazioni avanzate

  1. Espandere Il selettore di espansione nella sezione Advanced Braintree Settings.

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

  2. Per Vault Title, immettere un titolo descrittivo per il riferimento che identifichi l'insieme di credenziali in cui sono memorizzate le informazioni della scheda cliente.

  3. Immetti Merchant Account ID dal tuo account di Braintree.

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

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

  5. Se si desidera impedire l'invio della transazione per la valutazione come parte dei controlli degli strumenti fraudolenti avanzati, negli ordini inoltrati tramite l'amministratore, impostare Skip Fraud Checks on Admin Orders su Yes.

  6. Impostare Bypass Fraud Protection Threshold in modo che i controlli Advanced Fraud Protection vengano 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 Braintree, impostare Debug su 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 su Yes.

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

  9. Per inviare gli elementi riga carrello per tutti i metodi di pagamento, impostare Send Card Line Items su Yes.

  10. Per Credit Card Types, selezionare 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 di visualizzazione della Braintree quando questa viene elencata con altri metodi di pagamento durante l'estrazione.

Passaggio 4: completare le impostazioni del webhook di Braintree

Braintree impostazioni webhook

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

  2. Copia l'URL nel campo Fraud Protection URL e aggiungilo al tuo account di Braintree come Webhook Destination URL.

    note important
    IMPORTANT
    Questo URL deve essere sicuro e accessibile al pubblico.
  3. Impostare il campo Fraud Protection Approve Order Status per determinare quando la protezione antifrode viene approvata dalla Braintree.

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

  4. Impostare il campo Fraud Protection Reject Order Status per determinare quando la protezione contro le frodi viene 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 su uno dei seguenti:

    • All Allowed Countries - I clienti di tutti i paesi specificati nella configurazione del tuo negozio possono utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, viene visualizzato l'elenco Payment from Specific Countries. 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:

    • Fare clic su Add.

    • Imposta Country e scegli ogni 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

ACH tramite Braintree

  1. Per includere ACH come opzione di pagamento con Braintree, impostare Enable ACH Direct Debit su 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 eseguito il vaulting, i clienti possono riutilizzare l'Addebito automatico sul conto bancario senza dover reimmettere o autenticare le informazioni di pagamento se impostato su Yes.Enable Vault for ACH Direct Debit

  3. Per Sort Order, immettere 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 le impostazioni di Braintree

ApplePay tramite impostazioni Braintree

  1. Per includere Apple Pay come opzione di pagamento con Braintree, impostare Enable ApplePay through Braintree su Yes.

    Assicurati di verificare prima il nome di dominio nell'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 su Yes.

  3. Imposta Payment Action su uno dei seguenti:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente finché la vendita non viene acquisita dal commerciante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente ritirato dal conto del cliente.
  4. Per Merchant Name, immettere 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 viene visualizzata l'opzione di pagamento Apple Pay quando elencata 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 su Yes.

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

  3. Per Fallback Button Text, immettere il testo da utilizzare per il pulsante visualizzato nella pagina Braintree di fallback per riportare 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 Braintree nel pacchetto non supporta tutti i metodi di pagamento locali elencati nella documentazione per gli sviluppatori Braintree. 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 l'estrazione.

Passaggio 9: completare Google Pay tramite le impostazioni di Braintree

Pagamento Google tramite Braintree

  1. Per includere Google Pay come opzione di pagamento con Braintree, impostare Enable GooglePay Through Braintree su 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 su Yes.

  3. Imposta Payment Action su uno dei seguenti:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente finché la vendita non viene acquisita dal commerciante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente ritirato dal conto del cliente.
  4. Impostare Button Color per determinare il colore del pulsante Google Pay: White o Black

  5. Per Merchant ID, immetti il tuo ID commerciante (fornito da Google).

  6. Per Accepted Cards, selezionare il tipo di schede che un cliente può utilizzare 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 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 su Yes.

  2. Impostare Enable Vault for Venmo su Yes per consentire l'utilizzo di un archivio protetto per archiviare l'account Venmo dei clienti in modo che non sia necessario accedere nuovamente al proprio account Venmo per le transazioni future.

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

  3. Imposta Payment Action su uno dei seguenti:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente finché la vendita non viene acquisita dal commerciante.
    • Intent Sale - L'importo dell'acquisto è autorizzato e immediatamente ritirato 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 l'estrazione.

Passo 11: Completare PayPal attraverso le impostazioni di Braintree

PayPal tramite impostazioni Braintree

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

  2. Specifica il metodo di pagamento PayPal tramite Braintree:

    note note
    NOTE
    È possibile abilitare PayPal Credit o PayPal PayLater. Entrambi i metodi non possono essere attivati contemporaneamente.
    • Per includere PayPal Credit come opzione di pagamento con Braintree, impostare Enable PayPal Credit through Braintree su 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 il campo Merchant Country ​non è US o UK.
    • Per includere PayPal PayLater come opzione di pagamento con Braintree, impostare Enable PayPal PayLater through Braintree su Yes.

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

      Puoi visualizzare sul tuo sito i messaggi PayLater per le offerte, ad esempio Paga 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 il pagamento Braintree tramite PayPal durante l'acquisto.

  4. Imposta Vault Enabled su Yes per abilitare l'utilizzo di un insieme di credenziali protetto 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 su Yes per inviare gli articoli della 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 della linea.

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

  7. Per visualizzare il nome dell'esercente in modo diverso da quello definito nella configurazione archivio, immettere il nome nel campo Override Merchant Name come si desidera visualizzarlo.

  8. Imposta Payment Action su uno dei seguenti:

    • Authorize Only - Approva l'acquisto e blocca i fondi. L'importo non viene prelevato dal conto bancario del cliente finché la vendita non viene acquisita dal commerciante.
    • Authorize and Capture - L'importo dell'acquisto è autorizzato e immediatamente ritirato dal conto del cliente.
  9. Imposta Payment from Applicable Countries su uno dei seguenti per le transazioni Braintree elaborate da PayPal:

    • All Allowed Countries - I clienti di tutti i paesi specificati nella configurazione del tuo negozio possono utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, viene visualizzato l'elenco Payment from Specific Countries. 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 su 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 su Yes.

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

Passaggio 12: impostazione degli stili

  1. Per Location, scegli dove vengono visualizzati 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 nel campo Location.

  1. Imposta PayPal Button Type su 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 nel campo PayPal Button Type.

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

  2. Per Button Label, seleziona 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 campo di configurazione Size(Deprecated) è obsoleto e non viene utilizzato per assegnare uno stile ai pulsanti PayPal.

PayLater Messaging

  1. Per visualizzare i messaggi di PayLater nella vetrina nel percorso selezionato, impostare Show PayLater Messaging su Yes.

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

  2. Per Message Layout, selezionare il layout del messaggio PayLater: 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, selezionare il colore del testo del messaggio PayLater: 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 le posizioni, fare clic su Reset to Recommended Defaults.

Passaggio 13: completare le impostazioni di verifica 3D

  1. Se si desidera aggiungere un passaggio di verifica per i clienti che utilizzano carte di credito registrate in un programma di verifica, ad esempio Verified by VISA, impostare 3D Secure Verification su Yes.

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

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

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

  4. Imposta Verify for Applicable Countries su uno dei seguenti:

    • All Allowed Countries - I clienti di tutti i paesi specificati nella configurazione del tuo negozio possono utilizzare questo metodo di pagamento.
    • Specific Countries - Dopo aver scelto questa opzione, viene visualizzato l'elenco Verify for Specific Countries. 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

  1. Immettere il descrittore dinamico per Name, Phone e URL in base alle seguenti 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 delle parti company e product del descrittore può essere allocata nei modi seguenti, per una lunghezza combinata fino a 22 caratteri.

      Caratteri nel descrittore del nome

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

      Opzione 2: Company deve essere composto da sette caratteri, Product da un massimo di 14 caratteri

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

    • Phone - La lunghezza del descrittore telefonico deve essere compresa 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, fare 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 si esegue la migrazione a Commerce 2.4.x da una versione precedente alla 2.4.0 in cui è installata l'estensione Marketplace Braintree, è necessario disinstallare tale estensione (paypal/module-braintree o gene/module-braintree) e aggiornare le personalizzazioni del codice per utilizzare lo spazio dei nomi PayPal_Braintree anziché Magento_Braintree. Le impostazioni di configurazione dell'estensione del bundle Commerce Braintree Payments di base e dell'estensione distribuita su Commerce 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