Documentazione

1Registrazione Braintree

Puoi creare il tuo account Braintree direttamente online. Vai su https://signups.braintreepayments.com/ e registrati per un account esercente. Dopo aver fornito tutte le informazioni, riceverai le informazioni necessarie per creare la configurazione del gestore e del connettore all’interno dell’applicazione.

2Documentazione di configurazione Braintree

Una volta effettuata la registrazione per un account commerciante con Braintree, riceverai un’e-mail che contiene tutte le informazioni necessarie per accedere al backend di amministrazione commerciante Braintree.

2.1Utilizzare l’assistente di configurazione

Hai la possibilità di configurare il tuo account utilizzando l’assistente di configurazione nel tuo space. L’assistente di configurazione creerà per te i passaggi necessari per accettare pagamenti. Devi semplicemente inserire le credenziali richieste quando ti viene chiesto.

Di seguito trovi i passaggi di configurazione necessari senza utilizzare l’assistente di configurazione.

2.2Creare la configurazione del gestore

Innanzitutto è necessario configurare il gestore Braintree. Per farlo, vai a Space > Pagamento > Configurazione > Gestori. Seleziona Braintree dall’elenco dei gestori disponibili.

2.2.1Operation Mode

L’Operation Mode ti consente di scegliere tra la modalità sandbox e la modalità live. In modalità sandbox puoi testare l’integrazione senza effettuare transazioni live. Una volta terminati i test, puoi passare alla modalità live. Inserisci le tue credenziali per la modalità live e puoi iniziare a elaborare transazioni.

Note
Puoi elaborare transazioni live solo se disponi di un account live.

2.2.2Credenziali di base

La merchant ID nonché la chiave pubblica e privata possono essere generate nel back office di Braintree. Per farlo, accedi al tuo account sandbox o produzione e vai a Account > MyUser > API Keys, Tokenization Keys, Encryption Keys > View Authorizations.

Innanzitutto, copia la merchant ID nella configurazione del gestore.

braintree-merchant-id
Figure 1. Copia la tua merchant ID nella tua configurazione del gestore.

In secondo luogo, devi generare una nuova API Key se non l’hai già fatto. Fai clic su Generate New API Key. Questo genererà una nuova coppia di chiavi pubblica e privata che puoi inserire nella tua configurazione del gestore.

public-private-key
Figure 2. Copia la chiave pubblica e privata nella configurazione del gestore.

2.3Impostazioni dell’account

Braintree collega la valuta di elaborazione al Merchant Account ID. Pertanto, devi configurare il Merchant Account Id per ogni valuta che desideri elaborare.

Il Merchant Account ID e la valuta si trovano nel tuo account Braintree sotto Settings > Business > Merchant Accounts. Lì trovi il tuo Merchant Account ID e la valuta corrispondente. Inserisci questi valori anche nella tua configurazione del gestore.

Note
Il Merchant Account ID può essere diverso dalla Merchant ID. Assicurati di copiare l’account ID dal back office di Braintree nella configurazione.
merchant_accounts
Figure 3. Crea Merchant Accounts per valute diverse.

Ora salva la tua configurazione e crea i tipi di pagamento e i connettori mancanti per iniziare ad accettare pagamenti tramite il tuo account Braintree.

Note
Nel caso in cui desideri effettuare il regolamento in una nuova valuta. Devi creare un nuovo Merchant Account e selezionare la nuova valuta in cui desideri effettuare il regolamento. All’interno dell’applicazione puoi quindi creare una nuova configurazione del gestore per queste valute. Si consiglia di creare nuovi connettori per questi gestori e di applicare condizioni basate sulle valute.

2.4Configurazione dei connettori

Dopo aver salvato con successo la configurazione del gestore, puoi procedere con la configurazione dei tipi di pagamento e dei connettori. Per maggiori informazioni sul concetto di gestore, consulta la nostra documentazione sui pagamenti.

3Testare condizioni di errore nell’ambiente di test

Il gestore Braintree ti consente di simulare varie condizioni di errore negli ambienti di test, utilizzando importi diversi tra 2000 e 5000.01. Importi diversi causeranno codici di errore diversi. Consulta la sezione "Testing Amounts" su questa pagina di documentazione Braintree per maggiori dettagli.