TakePOS wallet

The module gives each third party a prepaid balance. It keeps no separate accounting: it relies on Dolibarr’s available credit, the one the core already uses for down payments and credit notes.

Top-up

It is done from the “Wallet” tab of the third-party card or the member card: amount, payment method, bank account, note. The module then runs, in a single transaction:

1. a one-line down payment invoice at 0% VAT, validated;
2. the payment of that invoice, deposited in the bank if the Banks & Cash module is enabled;
3. the invoice is classified as paid;
4. its conversion into available credit for the customer.

If one step fails, nothing is recorded in the database. The same tab shows the available balance and the history of top-ups and purchases.

On the member card, the tab shows the wallet of the third party linked to the member. A member who is not linked to any third party has no wallet: the tab says so.

At the till

On the TakePOS payment screen, a “Wallet (balance)” button appears when the customer of the sale has a balance and the sale is not settled.

• The browser sends no amount. The server applies at most the remaining amount, and at most the balance.
• The oldest credits are used first. A credit larger than needed is split in two: the part used, and the rest, which stays available.
• If the balance covers the sale, it is validated and paid with no other payment.
• Otherwise, the screen shows the remaining amount, to be paid in cash, by card or by cheque.
• The “Cancel” link gives the balance back.

The credit is applied as a payment, not as a discount: the receipt keeps its lines and its VAT, with no negative line.

Only credits coming from a top-up are used. The customer’s ordinary credit notes and down payments are never touched.

The balance is protected

If a draft sale to which the wallet has been applied is edited — line added, modified or deleted —, deleted, or changes customer, the applied amount is given back to the wallet. A new click on the button is enough.

This fills a gap in the core: when an invoice is deleted, Dolibarr does not release the credits applied to it as a payment.

Depending on the Dolibarr version

From 19 to 22, the TakePOS payment screen does not display buttons added by modules. On those versions, the module displays its button itself.

VAT

A top-up is recorded at 0% VAT: VAT is due at purchase time, on the receipt. This is the multi-purpose voucher treatment, valid when your products have different VAT rates.

If all your products share the same rate — for example food only at 5.5% —, the balance is a single-purpose voucher: VAT is due at top-up, and version 1.0.0 does not handle that case (French tax guidance BOI-TVA-CHAMP-10-10-40-50). Not relevant if your organisation is not liable for VAT. If in doubt, ask your accountant.

On the TakePOS payment screen, for a €107.60 sale incl. VAT, the “Porte-monnaie (51,60 €)” button (Wallet) appears under the keypad, alongside the “Espèce”, “Chèque” and “Carte bancaire” (cash, cheque, card) payment methods.

After a click, the balance does not cover the whole sale: €51.60 is applied, and the screen shows “Reste à payer: 56,00 €” (remaining amount), to be paid by another method. The button has disappeared, since the balance is used up. Under the buttons, the line “Porte-monnaie appliqué : 51,60 €” (Wallet applied) carries the “Annuler” (Cancel) link.

The “Porte-monnaie” (Wallet) tab of a member’s card, on Dolibarr 24.0.1: available balance of €51.60, linked third party, top-up form (amount, payment method, bank account, note), then the history — two top-ups of €50.00 and €20.00, two purchases of €12.00 and €6.40. Each row links to its invoice.

The module’s setup page is reserved for administrators. It opens with a reminder of how VAT is handled.

• Three dedicated permissions, not granted by default: “See wallet balances” opens the tab, “Top up a wallet” shows the top-up form, “Pay with the wallet at the till” shows the button in TakePOS.
• Dolibarr’s permission on top: to pay at the till, the user also needs the permission to create invoices.
• The tab respects permissions on third parties: it only opens on a third party the user has access to.
• The amount is calculated by the server. The browser only asks to apply or to cancel; the server applies at most the remaining amount and at most the balance.
• Protected requests: applying and cancelling only accept POST requests carrying Dolibarr’s anti-CSRF token. They are refused on a credit note, a down payment invoice or an invoice already paid.
• Transactions: a top-up or an application of the balance that fails midway is cancelled entirely.
• Automatic release of the balance when a draft sale changes or disappears.

• The module folder, dolixportemonnaie, to drop into htdocs/custom/ or to install from the zip.
• Three languages: French (fr_FR), English (en_US) and German (de_DE).
• No README or ChangeLog in the module folder.
• GPL v3 or later licence, complete and readable source code.

• One table is added: llx_dolixpm_recharge. It keeps one row per top-up: third party, down payment invoice, amount, date, user, note, entity. The balance is not stored there: it is the sum of the Dolibarr available credits coming from those down payment invoices.
• What is written at each top-up, through the core classes: a down payment invoice, its payment, the bank entry if the Banks & Cash module is enabled, and an available credit for the customer. On validation, Dolibarr generates the PDF of the down payment invoice, as for any invoice.
• What is written at the till: the credit used is linked to the sale, as a payment. The module adds no line to the sale.
• No Dolibarr file is modified. No outgoing connection.
• When the module is disabled, the tab and the till button disappear. Down payment invoices, payments and credits remain: they are data in your database, and unspent balances remain available credits of the customer in Dolibarr. The llx_dolixpm_recharge table and the module’s settings are not deleted.