Braintree
Braintree offre un’esperienza di pagamento completamente personalizzabile con rilevamento delle 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 di Braintree Payments è stata sviluppata da GENE Commerce.
Passaggio 1: ottieni le credenziali Braintree
Vai a Pagamenti Braintree 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.7.0 - Note sulla versione_, fare clic su Configure.
-
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 da Braintree. Quando si è pronti per passare alla produzione con Braintree, impostare Environment su
Production
. -
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 Braintree.
-
Immetti le seguenti credenziali dal tuo account 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
. -
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
. -
Se desideri che un cliente verifichi il numero CVV per la propria carta in archivio a ogni acquisto, imposta Enable Vault CVV Re-verification su
Yes
.
Passaggio 3: completare le impostazioni avanzate
-
Espandere
-
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 Braintree.
Se non si specifica l'account esercente da utilizzare, Braintree elabora la transazione utilizzando l'account 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 il Bypass Fraud Protection Threshold in modo che i
Advanced Fraud Protection
controlli vengano ignorati quando il soglia viene raggiunto o superato.Se questo campo viene lasciato vuoto, questa opzione viene disabilitata.
-
Se si desidera che il sistema salvi un file di registro delle interazioni tra il store e il Braintree, impostare Debug su
Yes
. -
Per richiedere ai clienti di fornire il codice di sicurezza a tre cifre dal retro di una scheda 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 Braintree account.
-
Per inviare gli elementi riga carrello per tutti i metodi di pagamento, impostare Send Card Line Items su
Yes
. -
Per Credit Card Types, selezionare tutte le carte di credito accettate 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, immetti un numero per determinare la sequenza in cui Braintree appare quando viene elencata con altri metodi di pagamento durante il checkout.
Passaggio 4: Tutte le applicazioni le impostazioni del webhook 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 Braintree come Webhook Destination URL.
note important IMPORTANT Questo URL deve essere sicuro e accessibile al pubblico. -
Imposta il campo Fraud Protection Approve Order Status per determinare quando la protezione antifrode viene approvata da Braintree.
Lo stato dell'ordine selezionato viene assegnato all'ordine Commerce.
-
Impostare il campo Fraud Protection Reject Order Status per determinare quando la protezione dalle frodi viene rifiutata da 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.
-
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 di 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 verrà visualizzata l'opzione di pagamento Braintree ACH 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 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)note note NOTE L'estensione Braintree nel pacchetto non supporta tutti i metodi di pagamento locali elencati nella documentazione per gli sviluppatori di 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 dalla banca del cliente account fino a quando la vendita non viene catturata dal commerciante.Intent Sale
- L'importo dell'acquisto è autorizzato e immediatamente ritirato dal account del cliente.
-
Impostare Button Color questa opzione per determinare il colore della Google Pay pulsante:
White
oppureBlack
-
Per Merchant ID, inserisci il tuo MerchantID (fornito da Google).
-
Per Accepted Cards, selezionare il tipo di carte 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 Venmo attraverso Braintree
-
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. -
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.
Passaggio 11: completare le impostazioni di PayPal tramite 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 di 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, immetti 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 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 saltare la pagina di revisione dell'ordine di PayPal Express, impostare Skip Order Review Step su
Yes
.Per i clienti che pagano con PayPal Express: se desideri che i clienti vengano reindirizzati a una pagina di revisione prima di completare il pagamento, imposta questo valore su
No
. Se si preferisce che i clienti saltino la pagina di revisione, impostarla suYes
. -
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
. -
Per inviare le informazioni di tracciamento del pacchetto a PayPal, imposta Send Package Tracking su
Yes
.Le informazioni di tracciamento dei pacchetti verranno inviate a PayPal solo per le transazioni/gli ordini PayPal. È necessario abilitare il campo di configurazione Send Cart Line Items for PayPal affinché la funzionalità Package Tracking funzioni correttamente.
-
Per notificare a un acquirente o a un pagatore tramite PayPal gli aggiornamenti per il monitoraggio del pacchetto, impostare Use PayPal’s “Notify Payer” functionality 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
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
oppureRectangle
-
Per Size (Deprecated), selezionare la dimensione pulsante PayPal:
Medium
,Large
oppureResponsive
Quando queste opzioni sono impostate, è possibile visualizzare l'anteprima dei pulsanti PayPal. Sono disponibili controlli che è possibile utilizzare per applicare le impostazioni o ripristinare i valori:
-
Per store le impostazioni di stile selezionate per i pulsanti e l'messaggistica 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: Messaggi posticipati
Product Page
-
Per visualizzare Pay Later messaggistica sulla vetrina della pagina del prodotto, imposta Show PayLater Messaging su
Yes
.Visualizza i messaggi Paga più tardi per le offerte disponibili. Si applicano delle restrizioni. Consulta la documentazione di PayPal.
-
Per Message Layout, selezionare il layout del messaggio Pay Later:
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
Cart
-
Per visualizzare i messaggi di Pay Later nella vetrina al mini-carrello o alla pagina del carrello, impostare Show PayLater Messaging su
Yes
.Visualizza i messaggi Paga più tardi per le offerte disponibili. Si applicano delle restrizioni. Consulta la documentazione di PayPal.
-
Per Message Layout, selezionare il layout del messaggio Pay Later:
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
Checkout
-
Per visualizzare i messaggi di Pay Later nella vetrina al momento del pagamento, impostare Show PayLater Messaging su
Yes
.Visualizza i messaggi Paga più tardi per le offerte disponibili. Si applicano delle restrizioni. Consulta la documentazione di PayPal.
-
Per Text Align, selezionare l'allineamento del testo per il messaggio Pay Later:
Text
oCenter
oRight
-
Per Text Color, selezionare il colore del testo del messaggio Pay Later:
Black
,White
Passaggio 14: 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, inserisci l'importo minimo dell'ordine necessario per attivare la verifica 3D.
-
Imposta Verify for Applicable Countries su una delle opzioni 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.
Passaggio 15: configurare i descrittori dinamici di 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 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 bundled 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.