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.
Passaggio 1: ottieni le credenziali Braintree
Vai a Braintree pagamenti e registrati per un account.
Passaggio 2: completare le impostazioni di base
-
Nella barra laterale Admin, passa a Stores > Settings>Configuration.
-
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.
-
-
In Recommended Solutions, nella sezione_Braintree Payments (di GENE Commerce v4.6.1 - Note sulla versione_, fare clic su Configure.
{width="600" modal="regular"}
-
Per Title, immettere un titolo che identifichi Braintree come opzione di pagamento durante l'estrazione.
-
Imposta Environment operativo corrente per le transazioni Braintree su
Sandbox
oProduction
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
.{width="600" modal="regular"}
-
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.|
-
Immetti Sandbox Merchant ID / Merchant ID dal tuo account di Braintree.
-
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. -
Prima di salvare la configurazione, fare clic su Validate Credentials per convalidare le credenziali.
-
Imposta Enable Card Payments su
Yes
.{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
-
Espandere nella sezione Advanced Braintree Settings.
{width="550" modal="regular"}
-
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.
-
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.
-
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
. -
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
. -
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.
-
Se si desidera che venga salvato un file di registro delle interazioni tra l'archivio e Braintree, impostare Debug su
Yes
. -
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.
-
Per inviare gli elementi riga carrello per tutti i metodi di pagamento, impostare Send Card Line Items su
Yes
. -
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.
-
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
-
Impostare Enable Webhook su
Yes
per abilitare la funzionalità webhook per la protezione dalle frodi, i pagamenti ACH e i metodi di pagamento locali. -
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. -
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.
-
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
-
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.
{width="600" modal="regular"}
-
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
-
Per includere ACH come opzione di pagamento con Braintree, impostare Enable ACH Direct Debit su
Yes
. -
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 -
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
-
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.
-
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
. -
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.
-
Per Merchant Name, immettere il testo che specifica l'etichetta visualizzata ai clienti nella finestra di dialogo Apple Pay.
-
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
-
Per includere i metodi di pagamento locali come opzione di pagamento con Braintree, impostare Enable Local Payment Methods su
Yes
. -
Per Title, immettere il testo da utilizzare per l'etichetta visualizzata nella sezione relativa al metodo di pagamento dell'estrazione (valore predefinito:
Local Payments
). -
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
). -
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
. -
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){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. -
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
-
Per includere Google Pay come opzione di pagamento con Braintree, impostare Enable GooglePay Through Braintree su
Yes
. -
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
. -
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.
-
Impostare Button Color per determinare il colore del pulsante Google Pay:
White
oBlack
-
Per Merchant ID, immetti il tuo ID commerciante (fornito da Google).
-
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
-
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
-
Per includere Venmo come opzione di pagamento con Braintree, impostare Enable Venmo through Braintree su
Yes
. -
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.{width="600" modal="regular"}
-
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.
-
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
-
Per includere PayPal come opzione di pagamento con Braintree, impostare Enable PayPal through Braintree su
Yes
. -
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
oUK
. -
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.
-
-
Per Title, inserisci un titolo che identifichi il pagamento Braintree tramite PayPal durante l'acquisto.
-
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. -
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. -
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.
-
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.
-
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.
-
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.
-
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. -
Per salvare un file di registro delle interazioni tra il tuo store e PayPal tramite Braintree, imposta Debug su
Yes
. -
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
-
Per Location, scegli dove vengono visualizzati i pulsanti e i messaggi PayPal:
Mini-Cart and Cart Page
,Checkout Page
oProduct Page
{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.
- 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.
-
Per visualizzare il pulsante PayPal sulla vetrina nella posizione selezionata, impostare Show PayPal Button su
Yes
. -
Per Button Label, seleziona l'etichetta del pulsante PayPal:
Paypal
,Checkout
,Buynow
oPay
-
Per Color, selezionare il colore del pulsante PayPal:
Blue
,Black
,Gold
oSilver
-
Per Shape, selezionare la forma pulsante PayPal:
Pill
oRectangle
-
Per Size (Deprecated), selezionare la dimensione del pulsante PayPal:
Medium
,Large
oResponsive
PayLater Messaging
-
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).
-
Per Message Layout, selezionare il layout del messaggio PayLater:
Text
oFlex
-
Per Logo, seleziona il tipo di logo PayPal:
Inline
,Primary
,Alternative
oNone
-
Per Logo Position, seleziona la posizione del logo PayPal:
Left
,Right
oTop
-
Per Text Color, selezionare il colore del testo del messaggio PayLater:
Black
,White
,Monochrome
oGrayscale
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
-
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.
-
Per soddisfare sempre la richiesta 3D Secure per tutte le transazioni, impostare Always request 3DS su
Yes
. -
Per Threshold Amount, immettere l'importo minimo dell'ordine necessario per attivare la verifica 3D.
-
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.
{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.
-
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
eproduct
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 caratteriOpzione 2:
Company
deve essere composto da sette caratteri,Product
da un massimo di 14 caratteriOpzione 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
-
-
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.