Airtime & Bill Payments in the Point of Sale
Sell mobile top-ups, data packages, bill payments and electronic PINs from the register you already use, through the TAECEL network (Mexico) — 30+ carriers, live balance and automatic settlement of interrupted sales.
The problem
A shop that sells airtime runs two businesses on one counter: the Point of Sale for its own products, and the provider’s web portal, in another tab, for every recharge. The recharge never reaches the ticket, the cash drawer never matches, and when a recharge hangs, nobody knows whether the customer was charged — so the cashier sends it again.
Nothing to learn: the cashier gets one more button, right where the register already keeps its actions — and it only shows up once a TAECEL account is connected:
That button opens the whole catalog, grouped as TAECEL publishes it — airtime, data packages, bill payments:
Fixed amounts come from the carrier itself, with the validity it publishes. Free-amount carriers (most utilities) ask for the amount instead:
The reference is validated before the sale, against the rules that carrier declares — its own label, minimum and maximum length, numeric or e-mail format, and a second field to confirm it. A recharge to a mistyped number cannot be undone, so it is caught here:
It lands as an ordinary order line — carrier and reference in plain sight for the cashier and on the printed receipt, next to the bread and the soda, in the same payment and the same cash count. Here an airtime top-up and an electricity bill on the same ticket:
What the shop gets
- 30+ Mexican carriers — Telcel, Movistar, AT&T, Unefon, Bait, Virgin, Weex and the rest, plus utilities such as CFE, Telmex, Sky, Dish and Megacable. The catalog is synchronised from TAECEL on demand and on a schedule, so new products appear without an update.
- Your own service fee per carrier, added to the line and printed on the receipt as TAECEL requires.
- Electronic PINs handed to the customer on the ticket.
- One product, not one per amount: every recharge is the same generic service product, so the product catalog stays clean.
Never a double recharge
TAECEL states it plainly: a successful recharge is never reversed, and anything left “in progress” is charged to you. So this module never guesses.
- Every sale is dispatched once, from the server, and then polled until TAECEL answers.
- A recharge that times out is parked, not retried. A scheduled job settles it against TAECEL’s own record of sales and closes it as successful or failed, with the folio.
- States that are already final are never re-queried, so a successful recharge can never be flipped by a later answer.
Every request is kept against its POS order, with folio, authorization and the amount actually charged:
Two wallets, guarded separately
TAECEL funds airtime and bill payments as separate balances, and they are not transferable. Both are read live from TAECEL and tracked independently, and the cashier is warned before a sale that would overdraw one — instead of finding out when the recharge fails at the counter.
Configuration
One account record holds the credentials, the commission and the Points of Sale allowed to sell. Test Connection, Sync Catalog and Refresh Balance are one click each; the catalog and the balances also refresh on a schedule. Deposit Sheet prints the reference each wallet is funded against — deposit at the bank and the balance is credited on its own, with no transfer to wait on.
Test mode points at TAECEL’s sandbox. Switch it off once TAECEL has validated your test transactions and issued production credentials.
The cashier manual comes with it
Installing the module writes a Knowledge article into your workspace: the whole counter routine in six steps, with screenshots, what each rejection reason means and what to do about it, the states the office sees, and how the wallets are funded. Written for the person at the till, in English or Spanish depending on your database — no training deck to prepare and nothing to hand out.
It is an ordinary article: edit it, add your own shop rules, and an update will not overwrite your changes. Requires the Knowledge app; on Community the module simply skips this step.
Requirements
- A TAECEL account with API access. TAECEL issues web-service credentials after its Levantamiento Tecnológico (cc@taecel.com) and after validating your test transactions. A distributor account on its own does not include API access.
- The Point of Sale must reach
https://taecel.comfrom the Odoo server — not from the browser. - Mexico only: TAECEL sells Mexican airtime and Mexican utilities.
Technical notes
- Dispatch happens server-side, in the POS order flow, so the credentials never reach the browser and a closed tab cannot leave a sale half-sent.
- Nothing is added to product.product per amount and no POS core model is replaced: the recharge is a normal order line carrying its TAECEL metadata.
- Runs on Odoo 18.0 and 19.0 from one codebase.
Compatibility
- Odoo 18.0 and 19.0, Community and Enterprise.
- Depends on Point of Sale (point_of_sale) only.
- English and Spanish (es_MX).
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 2561 |
| Technical Name |
xb_pos_taecel |
| License | OPL-1 |
| Website | https://xubax.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module