Damus
Franck profile picture
Franck
@Franck
🟦 Module 5 — TPoS (Tip Point of Sale)

Accéder au module LNbits
https://lnbits.com/extensions/tpos

---

📘 Essentiel

TPoS est un terminal de paiement Lightning ultra‑simple, pensé pour :

• commerces
• bars / cafés
• événements
• dons / tips
• vendeurs ambulants
• associations


Il permet d’encaisser des paiements Lightning sans exposer le wallet, via une interface minimaliste, compatible iPhone, tablette, ou vieux smartphone recyclé.

C’est le Point of Sale souverain le plus simple du Lightning.

---

⭐ Points clés

• Terminal Lightning minimaliste
• Montant libre ou montant fixe
• Interface claire, lisible, tactile
• QR dynamique (BOLT11 + LNURLp)
• Historique des paiements
• Aucun accès au wallet principal
• Mode “tip” ou “vente”
• Compatible iPhone / iPad / Android
• Fonctionne offline (QR pré‑généré) puis paiement online


---

🎯 Cas d’usage

1) Commerce physique

Encaisser des paiements Lightning en boutique.

2) Bars, cafés, food trucks

Montant libre → parfait pour tips ou petits achats.

3) Événements / conférences

Stand Lightning → paiement instantané.

4) Associations / dons

QR unique → montant libre → historique clair.

5) Artistes / créateurs

Tips Lightning en direct.

6) Micro‑services humains

Coiffeur, taxi, marché, artisan, etc.

---

🧭 Guide utilisateur

1. Activer l’extension

LNbits → Extensions → TPoS

2. Créer un terminal

Configurer :

• nom du terminal
• montant fixe ou libre
• description (optionnelle)
• image (optionnelle)


3. Utiliser le terminal

L’interface affiche :

• montant
• QR dynamique
• bouton “payer”
• statut du paiement


4. Encaisser

Le client scanne → paie → confirmation instantanée.

5. Suivre les paiements

Dashboard :

• liste des transactions
• montants
• timestamps
• messages (si activés)


---

🧩 Architecture

Flux :

1. L’utilisateur ouvre le terminal TPoS
2. LNbits génère une facture Lightning
3. Paiement → webhook interne
4. LNbits valide la transaction
5. Le terminal affiche “Paid”
6. Le wallet reçoit les sats


Dépendances :

• un wallet Lightning connecté
• aucune dépendance externe
• interface web responsive


---

🛠️ API

Endpoints principaux :

• POST /tpos/api/v1/tposs — créer un terminal
• GET /tpos/api/v1/tposs — lister
• GET /tpos/api/v1/tposs/{id} — récupérer
• DELETE /tpos/api/v1/tposs/{id} — supprimer


Webhook interne :
→ validation du paiement
→ mise à jour du terminal

---

⚠️ Limites

• Pas de catalogue produits
• Pas de gestion de TVA
• Pas de reçus clients
• Pas de multi‑utilisateurs avancé
• Pas de paiements récurrents

---

#utxofamas
#utxolnbits
#nostrfr

👀 tous les outils répertoriés :
https://utxo.univer.se/