1.2.3. Bank accounts management¶
To receive payments from customers, you need to configure one or more bank accounts. From multiple bank accounts Taler Exchange will automatically select the best one for each payment.
For each instance you can have multiple bank accounts, but same bank account can’t be connected to multiple instances.
In this tutorial you can find everything you need to know about bank accounts management in Taler Backoffice. For demonstration we will use the Taler Backoffice demo service
The access key is: sandbox.
and the Taler Bank demo service, where you can simulate bank account connections.
1.2.3.1. Bank accounts overview¶
To access bank accounts, navigate to the “Bank accounts” page from the sidebar. This page displays a list of all existing bank accounts, along with their details such as:
Wire method
Address
Owner’s name
1.2.3.2. Adding a bank account¶
To add a new bank account, click on the “+” button in the top-right corner of the page.
Here you have three options to add a bank account:
Manually via form: Manually add the bank account details.
Using Taler Revenue API: Connect to a bank account via the Taler Revenue API.
Importing from JSON: Use the “Import from bank” button to upload account details in JSON format.
1.2.3.2.1. Adding a bank account manually¶
After pressing the “+” button, you will see a page where you can enter your business bank account details.
1.2.3.2.1.1. Step 1: Select a wire method¶
Choose one of the following wire methods:
IBAN: Used for uniquely identifying bank accounts internationally, primarily in Europe. It is commonly used for wire transfers via SEPA (Single Euro Payments Area) and SWIFT networks.
Bitcoin: A decentralized cryptocurrency that enables global transactions between Bitcoin wallets. A Bitcoin address is used for uniquely identifying the account.
Ethereum: A blockchain-based cryptocurrency similar to Bitcoin, but also supporting smart contracts and decentralized applications (DApps).
X-taler-bank: Used for transfers between regional currency bank accounts, such as E-Netzbon.
The host identifies the bank. Similar for IBAN, but for regional currencies.
1.2.3.2.1.2. Step 2: Provide required details¶
Once you select a wire method, you must enter details based on your selection.
For the IBAN method, enter:
IBAN: The International Bank Account Number used for identifying bank accounts.
Owner’s name: The name of the account holder as it appears on the bank account.
After entering the details, click “Confirm” to add the bank account.
1.2.3.2.2. Connecting a bank account via Taler Revenue API¶
Fields above are used to get money to your bank account. This method is used to automatically reconcile payments with wire transfers at the bank.
To use this method, you need access to the Taler Revenue API, which is available through:
LibEuFin-Nexus (for European banks with EBICS core banking access)
Note
Using EBICS access may involve setup and recurring fees.
For this method we will use Taler Revenue API from the Taler Bank demo service.
You can also use Taler Bank demo service to get your own Taler Revenue API connection details.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.
1.2.3.2.2.1. Step 1: Enter API connection details¶
Fill in the form at the bottom of the page with the following details:
Endpoint URL: Enter here the URL of the bank’s Taler Revenue API you want to connect to.
Auth type: Select “Username and Password” as the authentication type.
Username: Enter the bank-issued username.
Password: Enter the bank-issued password.
1.2.3.2.2.2. Step 2: Test the connection¶
Click the “Test” button to verify the connection.
A pop-up window will display the fetched details. Click “Correct Form” to populate the form automatically.
Click “Test” again to match the server data with the form fields.
If Taler Revenue account details match, a green “Match” toggle switch will appear.
Click “Confirm” to add the bank account.
1.2.3.2.3. Importing a bank account from JSON¶
This method is useful when your bank provides account details in JSON format.
For this method we will use Taler Revenue API from the Taler Bank demo service.
You can also use Taler Bank demo service to get your own Taler Revenue API connection details.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.
1.2.3.2.3.1. Step 1: Import JSON data¶
Click the “Import from bank” button.
Paste the JSON data into the provided input field.
Click “Import” to automatically populate the form with the bank details.
1.2.3.2.3.2. Step 2: Validate the data¶
Click “Test” to verify the imported details.
If successful, a green “Match” toggle switch will appear.
Click “Confirm” to finalize and add the bank account.
1.2.3.3. Editing a bank account¶
To edit a bank account, click on the account you want to modify. Update the details as needed and click “Confirm” to save the changes.
All fields are described in the “Adding a bank account” section.
1.2.3.4. Deleting a bank account¶
To delete a bank account, click on the “Delete” button next to the account you want to remove.
Warning
This action is irreversible, but you can always add the bank account again.
Note
Bank accounts are never actually deleted; instead, they are marked as inactive, hidden from the list, and unavailable as payment targets. This ensures that all transactions can be completed and reconciled properly. To re-enable a bank account, you must add it again.