Sales > Payment Methods > Braintree

IMPORTANT
Migrazione di Commerce 2.4:

Per le versioni di Adobe Commerce e Magento Open Source precedenti alla 2.4.0, si è consigliato agli esercenti di installare e configurare l'estensione ufficiale per l'integrazione dei pagamenti di Braintree dalla Commerce Marketplace per sostituire l'integrazione di base. A partire dalla versione 2.4.0, l’estensione è ora inclusa nella versione core.



Durante la migrazione a Commerce 2.4, i commercianti devono disinstallare l'estensione distribuita nel Marketplace (paypal/module-braintree o gene/module-braintree) e aggiornare eventuali personalizzazioni del codice per utilizzare lo spazio dei nomi PayPal_Braintree invece di Magento_Braintree. Le impostazioni di configurazione dell’estensione inclusa nel bundle per Commerce e dell’estensione distribuita sulla Commerce Marketplace vengono mantenute. I pagamenti inseriti con tali versioni dell'estensione vengono acquisiti, annullati o rimborsati come di consueto.



Se si sta eseguendo l'aggiornamento a Commerce 2.4.0 e non si utilizza l'estensione Commerce Marketplace consigliata nella versione 2.3.x precedente, la funzionalità con più indirizzi non funziona con la versione 2.4.0 di Braintree. Quando un acquirente seleziona consegna a più indirizzi , il metodo di pagamento Braintree non viene visualizzato. L’estensione Commerce Marketplace precedentemente consigliata per 2.3.x presenta questo problema relativo a più indirizzi.

Per accedere alle impostazioni di configurazione dell'archivio, scegliere Stores > Settings>Configuration ​dalla barra laterale_ Amministratore _.

Basic Braintree Settings

Impostazioni Braintree di base

Campo
Ambito
Descrizione
Title
Visualizzazione store
Valore predefinito: Credit Card (Braintree)
Environment
Visualizzazione store
Opzioni: Sandbox / Production
Payment Action
Visualizzazione store
Determina l'azione eseguita dalla Braintree durante l'elaborazione di un pagamento. Opzioni:
Authorize- I fondi sulla carta di credito del cliente sono autorizzati, ma non trasferiti dal conto. Viene creato un ordine nell’amministratore del negozio. In seguito sarà possibile acquisire la vendita e creare una fattura.
Intent Sale (in precedenza Authorize and Capture nelle versioni precedenti): i fondi sulla carta di credito del cliente vengono autorizzati e acquisiti per Braintree e vengono creati un ordine e una fattura nell'amministratore del negozio.
Sandbox Merchant ID
Visualizzazione store
Questo è l’identificatore univoco dell’intero account gateway sandbox. Anche noto come ID pubblico o ID produzione, il tuo ID commerciante è diverso per i gateway di produzione e sandbox. Questo campo viene visualizzato quando il campo Environment ​è impostato su Sandbox.
Sandbox Public Key
Visualizzazione store
Questo è l'identificatore pubblico specifico dell'utente che limita l'accesso ai dati crittografati. Ogni utente associato al gateway di Braintree sandbox dispone di una propria chiave pubblica sandbox. Questo campo viene visualizzato quando il campo Environment ​è impostato su Sandbox.
Sandbox Private Key
Visualizzazione store
Si tratta dell'identificatore privato specifico dell'utente che limita l'accesso ai dati crittografati. Ogni utente associato al gateway Braintree Sandbox dispone di una propria chiave privata per la sandbox. Questo campo viene visualizzato quando il campo Environment ​è impostato su Sandbox.
Merchant ID
Visualizzazione store
Questo è l’identificatore univoco dell’intero account gateway, inclusi i diversi account esercente eventualmente presenti nel gateway. Anche noto come ID pubblico o ID produzione, il tuo ID commerciante è diverso per i gateway di produzione e sandbox. Questo campo viene visualizzato quando il campo Environment ​è impostato su Production.
Public Key
Visualizzazione store
Questo è l'identificatore pubblico specifico dell'utente che limita l'accesso ai dati crittografati. Ogni utente associato al gateway Braintree dispone di una propria chiave pubblica. Questo campo viene visualizzato quando il campo Environment ​è impostato su Production.
Private Key
Visualizzazione store
Si tratta dell'identificatore privato specifico dell'utente che limita l'accesso ai dati crittografati. Ogni utente associato al gateway Braintree dispone di una propria chiave privata. Questo campo viene visualizzato quando il campo Environment ​è impostato su Production.
Enable Card Payments
Sito Web
Determina se il metodo di pagamento con carta di credito Braintree è disponibile per i clienti come metodo di pagamento. Opzioni: Yes / No
Enable Vault for Card Payments
Sito Web
Quando questa opzione è abilitata, consente di memorizzare in modo sicuro le informazioni relative al pagamento del cliente, evitando così che i clienti debbano reinserire le informazioni sulla carta di credito per ogni acquisto. Opzioni: Yes / No
Enable Vault CVV Reverification
Sito Web
Quando questa opzione è abilitata, la convalida viene eseguita per l’impostazione delle regole del CVV nell’account Braintree. Opzioni: Yes / No

Advanced Braintree Settings

Braintree impostazioni avanzate

Campo
Ambito
Descrizione
Vault Title
Sito Web
Titolo descrittivo per il riferimento che identifica l'archivio in cui sono memorizzate le informazioni sulla scheda del cliente.
Merchant Account ID
Sito Web
ID dell'account esercente da associare alle transazioni di Braintree da questo sito Web. Se non specificato, viene utilizzato l'account commerciante predefinito del tuo account di Braintree.
Enable Checkout Express Payments
Sito Web
Fornisce 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. Opzioni: Yes / No
Skip Fraud Checks on Admin Orders
Sito Web
Impedisce l'invio della transazione per la valutazione come parte dei controlli Advanced Fraud Tools sugli ordini effettuati tramite l'amministratore solo quando è impostata su Yes.
Opzioni: Yes / No
Bypass Fraud Protection Threshold
Sito Web
Advanced Fraud Protection controlli vengono ignorati quando il valore di soglia viene raggiunto o superato. Se si lascia vuoto questo campo, questa opzione viene disabilitata.
Debug
Sito Web
Determina se le comunicazioni tra il sistema di Braintree e l'archivio vengono registrate in un file di registro. Opzioni: Yes / No
CVV Verification
Sito Web
Determina se i clienti devono fornire il codice di sicurezza a tre cifre dal retro di una carta di credito. Opzioni: Yes / No
Send Card Line Items
Sito Web
Invia le righe del carrello per tutti i metodi di pagamento. Opzioni: Yes / No
Credit Card Types
Sito Web
Specifica ogni carta di credito accettata come pagamento tramite Braintree. Premi e tieni premuto Ctrl (o Command su Mac) per selezionare una combinazione di schede. Opzioni: American Express / Visa / MasterCard / Discover / JCB / Diners / Maestro International
Sort Order
Sito Web
Determina l'ordine in cui la Braintree viene elencata con altri metodi di pagamento durante il pagamento.

Braintree Webhooks Settings

Braintree impostazioni webhook

Campo
Ambito
Descrizione
Enable Webhook
Sito Web
Per abilitare la funzionalità webhook per la protezione dalle frodi, i pagamenti ACH, i metodi di pagamento locali e le controversie. Opzioni: Yes / No
Fraud Protection URL
Sito Web
Aggiungi questo URL all'account Braintree come Webhook Destination URL. Questo URL deve essere protetto e accessibile al pubblico.
Fraud Protection Approve Order Status
Sito Web
Quando la protezione contro le frodi viene approvata per Braintree, lo stato dell'ordine selezionato viene assegnato all'ordine Commerce. Questo stato viene utilizzato per aggiornare lo stato dell'ordine in cui viene utilizzato il metodo di pagamento ACH e quando si passa a SETTLED in Braintree.
Fraud Protection Reject Order Status
Sito Web
Quando la protezione contro le frodi viene rifiutata dalla Braintree, lo stato dell'ordine selezionato viene assegnato all'ordine Commerce. Questo stato viene utilizzato per aggiornare lo stato dell'ordine in cui viene utilizzato il metodo di pagamento ACH e quando SETTLEMENT è DECLINED in Braintree.

Country Specific Settings

Impostazioni specifiche per paese

Campo
Ambito
Descrizione
Payment from Applicable Countries
Sito Web
Determina se si accettano pagamenti elaborati per Braintree da tutti i paesi o solo da paesi specifici. Opzioni: All Allowed Countries / Specific Countries
Payment from Specific Countries
Sito Web
Se applicabile, identifica i paesi specifici da cui si accettano i pagamenti elaborati per Braintree.
Country Specific Credit Card Types
Sito Web
Identifica le carte di credito accettate per paese per i pagamenti elaborati per Braintree. Viene salvato un record per ogni paese. Opzioni:
Country- Scegliere il paese.
Allowed Card Types - Selezionare ogni carta di credito accettata dal paese come pagamento tramite Braintree.
Add- Aggiungi una riga per consentire le carte di credito per un altro paese.
Action - Elimina il record delle carte di credito consentite per il paese.

ACH through Braintree

ACH tramite Braintree

Campo
Ambito
Descrizione
Enabled ACH Direct Debit
Sito Web
Determina se ACH Direct Debit è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No
Enable Vault for ACH Direct Debit
Sito Web
I clienti possono archiviare il metodo di pagamento con addebito diretto ACH a uso singolo per utilizzi futuri. Una volta archiviati i dettagli del pagamento, il cliente può utilizzare il metodo di pagamento con addebito diretto ACH senza reimmettere i dati o autenticare le informazioni di pagamento. Opzioni: Yes / No
Sort Order
Sito Web
Determina l'ordine in cui ACH Direct Debit è elencato con altri metodi di pagamento durante l'estrazione.

Apple Pay through Braintree

Pagamento Apple tramite Braintree

Campo
Ambito
Descrizione
Enable ApplePay through Braintree
Sito Web
Determina se Apple Pay è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No

Il dominio deve essere verificato prima nell'account di Braintree.
Enable Vault for ApplePay
Sito Web
I clienti possono archiviare/archiviare il metodo di pagamento Apple Pay per utilizzi futuri. Una volta archiviati i dettagli del pagamento, il cliente può utilizzare Apple Pay senza reinserire i dati o autenticare le informazioni di pagamento. Opzioni: Yes / No
Payment Action
Sito Web
Determina l'azione eseguita dalla Braintree durante l'elaborazione di un pagamento. Opzioni:
Authorize- I fondi sulla carta del cliente sono autorizzati, ma non trasferiti dall'account del cliente. Viene creato un ordine nell’amministratore del negozio. In seguito sarà possibile acquisire la vendita e creare una fattura.
Intent Sale - I fondi sulla carta del cliente sono autorizzati e acquisiti per Braintree e vengono creati un ordine e una fattura nell'amministratore del tuo negozio. Nota: si trattava di Authorize and Capture nelle versioni 2.3.x e precedenti.
Merchant Name
Visualizzazione store
Etichetta visualizzata ai clienti nel popup ApplePay.
Sort Order
Sito Web
Determina l'ordine in base al quale Apple Pay viene elencato con altri metodi di pagamento durante il pagamento.

Local Payment Methods

Metodi di pagamento locali

Campo
Ambito
Descrizione
Enabled Local Payment Methods
Sito Web
Determina se il metodo di pagamento locale è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No
Title
Sito Web
Etichetta visualizzata nella sezione relativa al metodo di pagamento del pagamento di pagamento. Valore predefinito: Local Payments
Fallback Button Text
Sito Web
Inserisci il testo da utilizzare per il pulsante visualizzato nella pagina della Braintree di fallback che riporta i clienti al sito web. Valore predefinito: Complete Checkout
Redirect on Fail
Sito Web
Specifica l'URL a cui devono essere reindirizzati i clienti 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.
Allowed Payment Method
Sito Web
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)
Sort Order
Sito Web
Determina l'ordine in base al quale il metodo di pagamento locale viene elencato con altri metodi di pagamento durante l'estrazione.
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.

GooglePay through Braintree

GooglePay tramite Braintree

Campo
Ambito
Descrizione
Enabled GooglePay through Braintree
Sito Web
Determina se il pagamento Google Pay è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No
Enable Vault for GooglePay
Sito Web
I clienti possono archiviare/archiviare il metodo di pagamento Google Pay per utilizzi futuri. Una volta archiviati i dettagli del pagamento, il cliente può utilizzare Google Pay senza reinserire i dati o autenticare le informazioni di pagamento. Opzioni: Yes / No
Payment Action
Sito Web
Determina l'azione eseguita dalla Braintree durante l'elaborazione di un pagamento. Opzioni:
Authorize- I fondi sulla carta del cliente sono autorizzati, ma non trasferiti dall'account del cliente. Viene creato un ordine nell’amministratore del negozio. In seguito sarà possibile acquisire la vendita e creare una fattura.
Intent Sale - I fondi sulla carta del cliente sono autorizzati e acquisiti per Braintree e vengono creati un ordine e una fattura nell'amministratore del tuo negozio. Nota: si trattava di Authorize and Capture nelle versioni 2.3.x e precedenti.
Button Color
Sito Web
Determina il colore del pulsante Google Pay. Opzioni: White / Black
Merchant ID
Visualizzazione store
L’ID fornito da Google deve essere inserito qui.
Accepted Cards
Sito Web
Selezionare il tipo di schede che un cliente può utilizzare per effettuare l'ordine utilizzando Google Pay.
Sort Order
Sito Web
Determina l'ordine in cui Google Pay viene elencato con altri metodi di pagamento durante il pagamento.

Venmo through Braintree

Venmo attraverso Braintree

Campo
Ambito
Descrizione
Enable Venmo through Braintree
Sito Web
Determina se Venmo è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No
Enable Vault for Venmo
Sito Web
I clienti possono archiviare il metodo di pagamento Venmo per utilizzarlo in futuro. Una volta archiviati i dettagli del pagamento, il cliente può utilizzare il metodo di pagamento Venmo senza inserire nuovamente i dati o autenticare nuovamente le informazioni di pagamento. Opzioni: Yes / No
Payment Action
Sito Web
Determina l'azione eseguita dalla Braintree durante l'elaborazione di un pagamento. Opzioni:
Authorize- I fondi sulla carta del cliente sono autorizzati, ma non trasferiti dall'account del cliente. Viene creato un ordine nell’amministratore del negozio. In seguito sarà possibile acquisire la vendita e creare una fattura.
Intent Sale - I fondi sulla carta del cliente sono autorizzati e acquisiti per Braintree e vengono creati un ordine e una fattura nell'amministratore del tuo negozio. Nota: questa versione era Autorizza e acquisisci nelle versioni 2.3.x e precedenti.
Sort Order
Sito Web
Determina l'ordine in cui Venmo viene elencato con altri metodi di pagamento durante il pagamento.

PayPal through Braintree

PayPal tramite Braintree

Campo
Ambito
Descrizione
Enable PayPal through Braintree
Sito Web
Determina se PayPal è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No
Enable PayPal Credit through Braintree
Sito Web
Determina se PayPal Credit è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No. Questo campo diventa visibile quando Enable PayPal through Braintree è impostato su Yes
Enable PayPal PayLater through Braintree
Sito Web
Determina se PayPal PayLater è incluso come metodo di pagamento tramite Braintree. Opzioni: Yes / No. Questo campo diventa visibile quando Enable PayPal through Braintree è impostato su Yes
Title
Visualizzazione store
L'etichetta che identifica PayPal tramite Braintree ai clienti durante il pagamento. Valore predefinito: PayPal
Vault Enabled
Sito Web
Quando questa opzione è abilitata, fornisce un archivio sicuro per le informazioni di pagamento del cliente, in modo che i clienti non debbano inserire nuovamente le informazioni PayPal per ogni acquisto. Opzioni: Yes / No
Send Cart Line Items for PayPal
Sito Web
Invia 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. Opzioni: Yes / No
Sort Order
Sito Web
Numero che determina l'ordine in cui PayPal tramite Braintree viene elencato con altri metodi di pagamento durante il pagamento.
Override Merchant Name
Visualizzazione store
Nome alternativo che può essere utilizzato per identificare l'esercente per ogni visualizzazione dello store.
Payment Action
Sito Web
Determina l'azione intrapresa da PayPal tramite Braintree quando viene elaborato un pagamento. Opzioni:
Authorize- I fondi sulla carta del cliente sono autorizzati, ma non trasferiti dall'account del cliente. Viene creato un ordine nell’amministratore del negozio. In seguito sarà possibile acquisire la vendita e creare una fattura.
Authorize and Capture - I fondi sulla carta del cliente sono autorizzati e acquisiti da PayPal tramite Braintree e vengono creati un ordine e una fattura nell'amministratore del tuo negozio.
Payment from Applicable Countries
Sito Web
Determina se si accettano i pagamenti elaborati da PayPal tramite Braintree da tutti i paesi o solo da paesi specifici. Opzioni: All Allowed Countries / Specific Countries
Payment from Specific Countries
Sito Web
Se applicabile, identifica i paesi specifici da cui si accettano i pagamenti elaborati per Braintree.
Require Customer’s Billing Address
Sito Web
Determina se l'indirizzo di fatturazione del cliente è necessario per sottomettere un ordine. Opzioni: Yes / No
Debug
Sito Web
Determina se le comunicazioni tra PayPal attraverso il sistema di Braintree e il tuo Negozio vengono registrate in un file di registro. Opzioni: Yes / No
Display on Shopping Cart
Sito Web
Determina se il pulsante PayPal viene visualizzato nel mini carrello e nella pagina carrello. Opzioni: Yes / No
NOTE
È possibile abilitare PayPal Credit o PayPal PayLater. Entrambi i metodi non possono essere attivati contemporaneamente.

Styling

Stile PayPal

Campo
Ambito
Descrizione
Location
Sito Web
Determina dove vengono riprodotti i pulsanti e i messaggi PayPal nella vetrina. Opzioni: Mini-Cart and Cart Page / Checkout Page / Product Page

Mini-Cart and Cart Page

L'opzione e le impostazioni in questa sezione variano a seconda dell'impostazione nel campo Location.

Campo
Ambito
Descrizione
PayPal Button Type
Sito Web
Imposta il pulsante su uno dei tre tipi seguenti: 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.

Campo
Ambito
Descrizione
Show PayPal Button
Sito Web
Determina la posizione del pulsante PayPal sull'ubicazione selezionata. Opzioni: Yes / No
Button Label
Sito Web
Determina l'etichetta del pulsante PayPal. Opzioni: Paypal / Checkout / Buy Now / Pay
Color
Sito Web
Determina il colore del pulsante PayPal. Opzioni: Blue / Black / Gold / Silver
Shape
Sito Web
Determina la forma del pulsante PayPal. Opzioni: Pill / Rectangle
Size(Deprecated)
Sito Web
Determina la dimensione del pulsante PayPal. Opzioni: Medium / Large / Responsive
NOTE
Il campo di configurazione Size(Deprecated) è obsoleto e non viene utilizzato per assegnare uno stile ai pulsanti PayPal.

PayLater Messaging

Campo
Ambito
Descrizione
Show PayLater Messaging
Sito Web
Abilita la messaggistica PayLater nella posizione selezionata. Opzioni: Yes / No. Quando è abilitato, il messaggio PayLater viene visualizzato per le offerte disponibili (restrizioni applicate).
Message Layout
Sito Web
Determina il layout del messaggio PayLater. Opzioni: Text / Flex
Logo
Sito Web
Determina il tipo di logo utilizzato per il pulsante PayPal. Opzioni: Inline / Primary / Alternative / None
Logo Position
Sito Web
Determina la posizione del logo per il pulsante PayPal. Opzioni: Left / Right / Top
Text Color
Sito Web
Determina il colore del testo del pulsante PayPal. Opzioni: Black / White / Monochrome / 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:

Campo
Ambito
Descrizione
Apply
Sito Web
Memorizza le impostazioni di stile selezionate per i pulsanti e i messaggi PayLater e le applica alla posizione corrente e al tipo di pulsante corrente.
Apply to All Buttons
Sito Web
Memorizza le impostazioni di stile selezionate per i pulsanti e i valori di messaggistica PayLater e le applica a tutti i tipi di pulsanti e a tutte le posizioni.
Reset to Recommended Defaults
Sito Web
Restituisce le impostazioni di stile ai valori predefiniti consigliati per i pulsanti e i messaggi PayLater e li applica a tutti i tipi di pulsanti e a tutte le posizioni.

Impostazioni di verifica 3d Secure

Impostazioni di verifica protetta 3D

Campo
Ambito
Descrizione
3D Secure Verification
Sito Web
Determina se una transazione deve superare un processo di verifica aggiuntivo quando il cliente è iscritto a un programma come Verified by VISA. Opzioni: Yes / No
Always request 3DS
Sito Web
Sfida la richiesta 3D Secure sempre per tutte le transazioni. Opzioni: Yes / No
Threshold Amount
Sito Web
Determina l'importo massimo dell'ordine autorizzato per l'elaborazione in un singolo ordine. Braintree rifiuta l'autorizzazione se l'importo dell'ordine supera tale soglia.
Verify for Applicable Countries
Sito Web
Determina i paesi in cui è necessario verificare il pagamento. Opzioni: All Allowed Countries / Specific Countries
Verify for Specific Countries
Sito Web
Se del caso, indica i paesi specifici da cui devono essere verificati i pagamenti per Braintree.

Dynamic Descriptors

Descrittori dinamici

Campo
Ambito
Descrizione
Name
Visualizzazione store
Il descrittore Nome è costituito da due parti, separate da un asterisco (*). La prima parte del descrittore identifica l’azienda o il DBA e la seconda parte identifica il prodotto. Ad esempio: company*myproduct

La lunghezza delle parti Società e Prodotto del descrittore può essere allocata nei seguenti modi, per una lunghezza combinata fino a 22 caratteri:
Option 1- Azienda deve essere tre caratteri / Prodotto può essere fino a 18 caratteri
Option 2 - Azienda deve essere sette caratteri / Prodotto può essere fino a 14 caratteri
Option 3- Azienda deve essere 12 caratteri / Prodotto può essere fino a nove caratteri
Phone
Visualizzazione store
Il descrittore del telefono deve contenere da dieci a 14 caratteri e può includere solo numeri, trattini, parentesi e punti. Esempio: 9999999999 (999) 999-9999 999.999.9999
URL
Visualizzazione store
Il descrittore URL rappresenta il nome di dominio e può contenere fino a 13 caratteri. Esempio: company.com
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672