2.1.4. Gestione dei conti bancari#

Per ricevere i pagamenti dai clienti, è necessario aggiungere uno o più conti bancari. Se sono presenti più conti bancari, il backend Taler Merchant selezionerà automaticamente quello migliore per ogni pagamento.

Per ogni istanza è possibile avere più conti bancari, ma lo stesso conto bancario non può essere collegato a più istanze.

In questo tutorial troverete tutto quello che c’è da sapere sulla gestione dei conti bancari nel Taler Backoffice. A titolo dimostrativo utilizzeremo il servizio demo di Taler Backoffice

La chiave di accesso è: sandbox.

e il servizio demo di Taler Bank, che simula una banca.

2.1.4.1. Panoramica dei conti bancari#

Per accedere ai conti bancari, andare alla pagina «Bank accounts» dalla barra laterale. In questa pagina viene visualizzato l’elenco di tutti i conti bancari esistenti, con i relativi dettagli, quali:

  • Metodo di bonifico

  • Indirizzo del conto

  • Nome del proprietario

Il metodo di bonifico specifica il modo in cui il denaro viene trasferito elettronicamente tra conti bancari, a seconda del tipo di sistema di pagamento utilizzato (ad esempio, IBAN, Bitcoin, Ethereum).

2.1.4.2. Aggiunta di un conto bancario#

Per aggiungere un nuovo conto bancario, fare clic sul pulsante «+» nell’angolo superiore destro della pagina.

Qui sono disponibili tre opzioni per aggiungere un conto bancario:

  1. Manualmente tramite modulo: Aggiungere manualmente le coordinate bancarie.

  2. Utilizzando Taler Revenue API: Collegarsi a un conto bancario tramite l’API di Taler Revenue.

  3. Importazione da JSON: Utilizzare il pulsante «Import from bank» per caricare i dati del conto in formato JSON.

2.1.4.2.1. Aggiunta manuale di un conto bancario#

Dopo aver premuto il pulsante «+», viene visualizzata una pagina in cui è possibile inserire i dati del conto bancario aziendale.

Fase 1: selezionare un metodo di bonifico

Scegliere uno dei seguenti metodi di bonifico:

  • IBAN: Utilizzato per identificare in modo univoco i conti bancari a livello internazionale, soprattutto in Europa. È comunemente utilizzato per i bonifici bancari attraverso le reti SEPA (Single Euro Payments Area) e SWIFT.

  • Bitcoin: Una criptovaluta decentralizzata che consente transazioni globali tra portafogli Bitcoin. Un indirizzo Bitcoin viene utilizzato per identificare in modo univoco il conto.

  • Ethereum: Una criptovaluta basata su blockchain simile a Bitcoin, ma che supporta anche contratti intelligenti e applicazioni decentralizzate (DApp).

  • X-taler-bank: Utilizzato per i trasferimenti tra conti bancari in valuta regionale, come E-Netzbon.

L’host identifica la banca. Simile all’IBAN, ma per le valute regionali.

Fase 2: fornire i dati richiesti

Una volta selezionato un metodo di bonifico, è necessario inserire i dettagli in base alla scelta effettuata.

Per il metodo IBAN, inserire:

  • IBAN: Numero di conto bancario internazionale utilizzato per identificare i conti bancari.

  • Nome del proprietario: Il nome del titolare del conto così come appare sul conto bancario.

Dopo aver inserito i dati, fare clic su «Confirm» per aggiungere il conto bancario.

2.1.4.2.2. Collegamento di un conto bancario tramite Taler Revenue API#

I campi precedenti sono utilizzati per ottenere denaro sul conto bancario. Questo metodo viene utilizzato per riconciliare automaticamente i pagamenti con i bonifici bancari.

Per utilizzare questo metodo, è necessario accedere alla Taler Revenue API, disponibile tramite:

Nota

L’utilizzo dell’accesso EBICS può comportare commissioni di configurazione e commissioni ricorrenti.

Per questo metodo utilizzeremo l’opzione che consente di esportare i dettagli tramite JSON dal servizio demo di Taler Bank.

È inoltre possibile utilizzare il servizio demo di Taler Bank per ottenere i dettagli di connessione del proprio conto bancario.
1. Register and Login to the account.
2. Navigate to your profile page.
3. In the «Merchant integration» section, you will find all necessary details.

Passo 1: Inserire i dettagli della connessione API

Compilate il modulo in fondo alla pagina con i seguenti dati:

  • URL dell’endpoint: Inserire qui l’URL della Taler Revenue API della banca a cui ci si vuole connettere.

  • Tipo di autenticazione: Selezionare «Username and Password» come tipo di autenticazione.

  • Nome utente: Inserire il nome utente rilasciato dalla banca.

  • Password: Inserire la password rilasciata dalla banca.

Fase 2: Prova della connessione

  1. Fare clic sul pulsante «Test» per verificare la connessione.

  2. Una finestra a comparsa mostrerà i dettagli recuperati. Fare clic su «Correct Form» per compilare automaticamente il modulo.

  3. Fare nuovamente clic su «Test» per far coincidere i dati del server con i campi del modulo.

  4. Se i dettagli del conto Taler Revenue corrispondono, apparirà un interruttore verde «Match».

Fare clic su «Confirm» per aggiungere il conto bancario.

2.1.4.3. Modifica di un conto bancario#

Per modificare un conto bancario, fare clic sul conto che si desidera modificare. Aggiornare i dettagli se necessario e fare clic su «Confirm» per salvare le modifiche.

Tutti i campi sono descritti nella sezione Aggiunta di un conto bancario.

2.1.4.4. Eliminazione di un conto bancario#

Per eliminare un conto bancario, fare clic sul pulsante «Delete» accanto al conto che si desidera rimuovere.

Avvertimento

Questa azione è irreversibile, ma è sempre possibile aggiungere nuovamente il conto bancario.

Nota

I conti bancari non vengono mai eliminati, ma vengono contrassegnati come inattivi, nascosti dall’elenco e non disponibili per i pagamenti. Ciò garantisce che tutte le transazioni possano essere completate e riconciliate correttamente. Per riattivare un conto bancario, è necessario aggiungerlo nuovamente.