KAI-Pay

Caisse – Guide du commerçant

Avec la caisse KAI-Pay, vous acceptez des paiements en bitcoin via Lightning, par exemple au comptoir ou sur un stand de marché. La caisse est une page distincte (kasse.kai-pay.net) sans clés : elle peut seulement créer des factures, mais pas envoyer d’argent. Chaque paiement va directement dans votre portefeuille KAI-Pay en auto-garde. Vous y voyez les clôtures journalière et mensuelle et pouvez effectuer des remboursements.

KAI-Pay est une bêta publique. La caisse est un terminal de paiement, pas une caisse enregistreuse (voir Limites).

1. Prérequis

2. Configurer la caisse

  1. Dans le portefeuille, ouvrez le menu et choisissez « Caisse et clôture ». Tout en bas se trouve « Configurer la caisse ».
  2. Si vous le souhaitez, saisissez un nom de caisse, par exemple « Comptoir 1 » ou « Marché ». Le lien et le code QR changent avec le nom.
  3. Ouvrez la caisse :
    • Sur le même appareil : « Ouvrir la caisse sur cet appareil ». La caisse s’ouvre dans un nouvel onglet ou, dans l’application Android, dans le navigateur.
    • Sur un appareil de caisse dédié (p. ex. une tablette au comptoir) : scannez le code QR avec cet appareil, ou copiez ou partagez le lien et ouvrez-le sur cet appareil.

Le lien contient votre adresse Lightning, le nom de la caisse et une clé publique des reçus. Ces informations figurent dans la partie du lien située après « # » ; elles ne sont transmises à aucun serveur. La caisse les enregistre sur l’appareil de caisse. Lorsque vous ouvrez à nouveau kasse.kai-pay.net, elle démarre directement ; vous n’avez alors plus besoin du lien.

Si quelqu’un ouvre, sur un appareil de caisse déjà configuré, un lien avec une autre adresse ou une autre clé des reçus, la caisse demande confirmation avant de basculer. Ne confirmez que si vous l’avez configuré vous-même. La caisse et le portefeuille affichent l’empreinte de la clé des reçus ; vous pouvez la comparer.

3. Encaisser

  1. Saisissez le montant : dans une monnaie locale (EUR, USD, GBP, CHF, CAD, AUD ou JPY, convertie au cours de mempool.space affiché avec son heure de mise à jour) ou en sat (« Saisir en sat »). Le cours est fixé pour la facture. En monnaie locale, la caisse n’encaisse qu’avec un cours récupéré il y a 5 minutes au plus et datant, selon mempool.space, de 30 minutes au plus.
  2. « Encaisser » : la caisse affiche une facture sous forme de code QR.
  3. Le client ou la cliente la scanne avec n’importe quel portefeuille Lightning et paie.
  4. La caisse affiche « Payé » et un reçu de paiement numéroté. C’est un justificatif de paiement, pas un ticket de caisse. « Reçu en PDF » l’enregistre sous forme de fichier.

Messages de la caisse :

Encaisser avec des articles

  1. « Gérer les articles » : nom, prix et devise du prix (monnaie locale ou sat), au choix catégorie et taux de taxe. Le taux de taxe n’est qu’une indication sur le reçu ; KAI-Pay ne calcule aucune taxe.
  2. « Articles » : touchez les articles, modifiez la quantité avec − et +. Un panier a exactement une devise.
  3. « Encaisser » : le total devient la facture. Les lignes, les prix et le cours sont fixés pour cette commande – les changements de prix ultérieurs ne modifient pas les reçus payés.

Les articles sont enregistrés uniquement sur l’appareil de caisse. « Exporter le catalogue » les enregistre dans un fichier ; reprenez-les dans une autre caisse ou dans le portefeuille (Caisse et clôture → Articles) avec « Importer le catalogue ». Le portefeuille n’a besoin du catalogue que pour afficher les lignes avec leur nom ; une nouvelle importation ne modifie pas les noms des articles déjà importés. Renommer un article crée un nouvel article dans la caisse, afin que les anciens reçus conservent leur nom.

Les lignes et les montants dans d’autres devises que l’euro n’arrivent dans le portefeuille que si la caisse a été configurée avec le lien de caisse actuel de votre portefeuille. Pour les caisses configurées avec un lien plus ancien : rouvrez une fois le lien de caisse dans le portefeuille. D’ici là, les lignes figurent uniquement sur le reçu de la caisse.

Reçu en PDF

La caisse et le portefeuille génèrent le reçu PDF sur l’appareil à partir des données enregistrées, sans serveur ; généré à nouveau, le même paiement donne le même fichier (même langue et même fuseau horaire). La caisse ne conserve des reçus que pour ses dernières factures (20 au maximum des 7 derniers jours). C’est un justificatif de paiement, ni une facture au sens du § 14 UStG (Allemagne), ni un ticket de caisse. Pour les remboursements, le portefeuille crée un reçu de remboursement distinct.

4. Nom de la caisse et plusieurs caisses

Le portefeuille n’enregistre pas le nom de la caisse. Ce nom voyage ainsi :

  1. Le nom figure dans le lien. La caisse l’enregistre sur l’appareil de caisse, avec un identifiant d’appareil aléatoire et un compteur de reçus séquentiel.
  2. À chaque paiement, la caisse envoie une note chiffrée : identifiant de l’appareil, nom de la caisse, numéro de reçu, montant en monnaie locale et cours, et pour les articles également les lignes. Seul votre portefeuille peut la lire.
  3. Le portefeuille lit ces notes dans les paiements et, dans la clôture, les attribue aux différentes caisses.

5. Clôture journalière

Dans le portefeuille, sous « Caisse et clôture », choisissez un jour. Pour chaque caisse, vous voyez :

En outre, le portefeuille indique les « Autres réceptions » (paiements à votre adresse qui ne sont pas passés par la caisse) et les paiements encore en attente.

6. Clôture mensuelle et export CSV

« Exporter le jour en CSV » ou « Exporter le mois en CSV » enregistre un fichier avec une ligne par transaction :

À la fin figurent les totaux en sat et par monnaie locale.

Le portefeuille ne tient pas pour cela de livre de caisse propre. Il calcule la clôture à chaque fois à partir de l’historique des paiements. Vous pouvez donc exporter à nouveau n’importe quel mois passé, tant que les paiements figurent dans l’historique. Le portefeuille dérive la clé des notes de reçu de vos 12 mots ; même après une restauration, les notes restent lisibles.

L’export de la caisse ne contient que les paiements passés par la caisse. Pour une vue d’ensemble de toutes les recettes, exportez en plus l’historique du portefeuille en CSV ; il contient chaque paiement.

7. Remboursement

  1. Dans le portefeuille, ouvrez dans l’historique le paiement provenant de la caisse et choisissez « Rembourser ».
  2. Saisissez l’adresse Lightning ou la facture du client ou de la cliente. Vous pouvez rembourser au maximum le montant restant.
  3. Vérifiez et confirmez. Le remboursement apparaît dans la clôture en négatif. Pour les adresses Lightning qui acceptent une note, le portefeuille joint « Remboursement du reçu … ».

Le portefeuille enregistre l’association « remboursement du reçu » uniquement sur l’appareil depuis lequel vous avez effectué le remboursement. Si un remboursement est encore en cours, le portefeuille vous avertit avant d’en effectuer un second.

8. Sécurité et données

9. Limites

Des questions ? Questions fréquentes ou kontakt@kai-pay.net.