2.1.3. Gestione dei conti bancari#

Per ricevere i pagamenti dai clienti, è necessario configurare uno o più conti bancari. Tra più conti bancari, Taler Exchange 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 in Taler Backoffice. A titolo dimostrativo utilizzeremo il servizio demo di Taler Backoffice <https://backend.demo.taler.net/instances/sandbox/>`_.

La chiave di accesso è: sandbox.

e il servizio demo di Taler Bank, dove è possibile simulare connessioni di conti bancari.

2.1.3.1. Panoramica dei conti bancari#

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

  • Metodo del filo

  • Indirizzo del conto

  • Nome del proprietario

Il metodo wire 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.3.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 «Importa dalla banca « per caricare i dati del conto in formato JSON.

2.1.3.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 cablaggio

Scegliere uno dei seguenti metodi di cablaggio:

  • 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 pagamento, è 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 «Conferma « per aggiungere il conto bancario.

2.1.3.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 costi di configurazione e spese ricorrenti.

Per questo metodo utilizzeremo l’API di Taler Revenue dal servizio demo di Taler Bank.

È inoltre possibile utilizzare il servizio demo di Taler Bank <https://bank.demo.taler.net/>`_ per ottenere i dettagli di connessione all’API di Taler Revenue.
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 «Nome utente e 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 «Modulo corretto « 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, appare un interruttore verde «Match «.

Fare clic su «Conferma « per aggiungere il conto bancario.

2.1.3.2.3. Importare un conto bancario da JSON#

Questo metodo è utile quando la banca fornisce i dettagli del conto in formato JSON.

Per questo metodo utilizzeremo l’API di Taler Revenue dal servizio demo di Taler Bank.

Per configurare LibEuFin-Nexus, consultare il nostro tutorial su LibEuFin.

È inoltre possibile utilizzare il servizio demo di Taler Bank <https://bank.demo.taler.net/>`_ per ottenere i dettagli di connessione all’API di Taler Revenue.
1. Register and Login to the account.
2. Navigate to your profile page.
3. In the «Merchant integration» section, you will see «Copy» buttons to copy all necessary details in JSON format.

Passo 1: Importare i dati JSON

  1. Fare clic sul pulsante «Importa da banca «.

  2. Incollare i dati JSON nel campo di input fornito.

  3. Fare clic su «Importa « per riempire automaticamente il modulo con le coordinate bancarie.

Fase 2: Convalida dei dati

  1. Fare clic su «Test « per verificare i dettagli importati.

  2. In caso di successo, apparirà un interruttore verde «Match «.

Fare clic su «Conferma « per finalizzare e aggiungere il conto bancario.

2.1.3.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 «Conferma « per salvare le modifiche.

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

2.1.3.4. Eliminazione di un conto bancario#

Per eliminare un conto bancario, fare clic sul pulsante «Elimina « 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.