Guide de l’utilisateur

1.1. Guide de l’utilisateur#

1.1.1. Introduction#

1.1.1.1. À propos de GNU Taler#

1.1.1.2. À propos de ce guide#

Ce guide explique les différentes façons dont les utilisateurs peuvent interagir avec une installation GNU Taler. Il suppose qu’une banque, une bourse et un backend marchand fonctionnent et que l’utilisateur a un portefeuille GNU Taler installé et est capable de créer un compte à la banque. Certaines opérations nécessitent également l’accès au backend du commerçant.

1.1.2. Retraits sur les comptes bancaires#

Le retrait est l’étape où l’argent est transféré d’un compte bancaire vers un portefeuille GNU Taler. Il y a deux façons principales de procéder.

1.1.2.1. Retrait intégré à la banque#

Si la banque le prend en charge, vous pouvez retirer de l’argent dans votre portefeuille GNU Taler directement à partir de votre application bancaire ou du site web de votre banque en ligne. S’il est pris en charge, il devrait y avoir une option dans votre banque en ligne pour retirer de l’argent vers un portefeuille GNU Taler. La banque devrait vous demander le montant et générer un code QR que vous devez scanner avec votre portefeuille GNU Taler. Alternativement, si le portefeuille WebExtension est installé, le site web de la banque peut directement basculer vers le portefeuille GNU Taler. Dans le portefeuille GNU Taler, il se peut que vous deviez d’abord confirmer les conditions de service de la bourse GNU Taler sélectionnée. Ensuite, les frais applicables seront affichés et vous aurez la possibilité d’accepter le retrait. Ensuite, vous devez autoriser l’opération de retrait auprès de la banque. Si possible, le portefeuille GNU Taler peut automatiquement basculer vers le site web de la banque, mais il est également possible que vous deviez retourner explicitement à l’application bancaire. Après avoir autorisé l’opération de retrait, vous devrez attendre un peu que l’argent soit viré à l’échange. Selon le système bancaire, cela peut prendre de quelques secondes à plusieurs heures. Ensuite, l’argent apparaîtra dans votre portefeuille.

1.1.2.2. Retrait initié par le portefeuille#

Dans ce cas, vous commencerez le processus de retrait à partir du portefeuille GNU Taler. Sous « Paramètres », vous trouverez une liste de bourses. Si la liste est vide ou ne contient pas la bourse souhaitée, vous devrez peut-être d’abord l’ajouter en fournissant l’URL correspondante. Le prestataire de services de paiement qui exploite le service d’échange devrait disposer d’un tel code QR sur son site web.

À côté de l’échange, un menu déroulant propose l’option « retirer ». (Si vous avez déjà de l’argent dans votre portefeuille, vous trouverez également le même bouton lorsque vous consulterez l’historique des transactions de la devise concernée). Le portefeuille vous demandera d’entrer le montant à retirer, d’accepter les conditions de service et de payer les frais applicables (le cas échéant). Ensuite, le portefeuille vous donnera des instructions de virement, vous indiquant quel montant virer sur quel compte bancaire. Plus important encore, le portefeuille vous donnera un sujet de virement qui doit être spécifié pour le virement. Si vous faites une faute de frappe dans l’objet du virement, le portefeuille ne sera pas rechargé et la bourse renverra l’argent sur votre compte bancaire (éventuellement avec des frais en moins). Il vous suffit d’effectuer le virement selon les instructions du portefeuille. Une fois l’argent arrivé à la bourse, le portefeuille retirera automatiquement les fonds.

1.1.3. Dépôt sur des comptes bancaires#

Si vous avez de l’argent dans votre portefeuille, vous pouvez utiliser le bouton « déposer » pour déposer les fonds sur un compte bancaire. Le portefeuille vous demandera de spécifier le montant et le compte bancaire cible.

1.1.4. Envoi d’espèces numériques#

Une fois que vous avez de l’argent numérique, vous pouvez l’envoyer à un autre portefeuille GNU Taler. Il vous suffit de spécifier le montant et une raison lisible par l’homme pour le transfert. Le portefeuille affichera alors un code QR (et offrira la possibilité d’exporter le paiement en tant que taler://-URL). Envoyez l’image du code QR au portefeuille destinataire (ou envoyez le taler://-URL de manière sécurisée au portefeuille cible).

Le portefeuille cible doit scanner le code QR (ou saisir le texte de l’URL taler://-URL dans la boîte de dialogue d’importation d’URL qui est disponible en maintenant ou en cliquant sur le bouton de scan du code QR). Ensuite, il doit examiner le texte du motif et accepter les fonds pour terminer la transaction.

1.1.5. Recevoir de l’argent numérique#

Pour recevoir des fonds d’un autre utilisateur, vous pouvez envoyer une demande de paiement à un autre portefeuille GNU Taler. Il suffit de spécifier le montant et une raison lisible par l’homme pour la demande de paiement. Le portefeuille affichera alors un code QR (et offrira la possibilité d’exporter la demande de paiement en tant que taler://-URL). Envoyez l’image du code QR au portefeuille du payeur (ou envoyez le taler://-URL au portefeuille cible).

Le portefeuille cible doit scanner le code QR (ou saisir le texte de l’URL taler:// dans la boîte de dialogue d’importation d’URL qui est disponible en maintenant ou en cliquant sur le bouton de scan du code QR). Examinez ensuite la raison de la demande de paiement et décidez de la payer ou non. Sélectionnez « payer » pour terminer la transaction.

En fonction de la configuration de l’échange, le portefeuille récepteur peut être soumis à un contrôle KYC avant que les fonds ne soient effectivement libérés pour le destinataire.

1.1.6. Configuration des comptes dans une instance de commerçant#

Avant de pouvoir mettre en place une instance de marchand, vous avez besoin que quelqu’un gère un Taler Merchant Backend et vous attribue l’accès à une instance à ce backend. Pour cela, vous devez recevoir l’URL de base de l’instance et un jeton d’accès.

Les principales données de configuration qui doivent être fournies pour chaque instance sont les informations relatives au compte bancaire.

Pour recevoir des paiements, le backend du commerçant doit communiquer les coordonnées du compte bancaire à l’échange.

Les informations sur le compte bancaire sont fournies sous la forme d’une payto://-URI. Voir RFC 8905 pour le format des payto://-URIs. Notez que le « nom du destinataire » est optionnel dans la RFC 8905 mais obligatoire dans GNU Taler.

For first tests, you may want to sign up for a KUDOS bank account at https://bank.demo.taler.net/. In this case, the payto://-URI will be of the form payto://iban/$IBAN?receiver-name=$NAME where $IBAN must be replaced with the IBAN shown on the main page of the account shown at https://bank.demo.taler.net/ after logging in.

Lorsque vous déployez Taler avec le système bancaire réel, vous devez principalement changer la devise de la configuration de KUDOS à la devise réelle (comme EUR, USD, CHF) et fournir un payto://-URI de votre compte bancaire réel. En Europe, cela implique de connaître votre numéro IBAN. Si vous avez un IBAN, le payto://-URI correspondant est simplement payto://iban/$IBAN?receiver-name=$NAME où $IBAN doit être remplacé par le numéro IBAN réel et $NAME par votre nom réel. Veillez à encoder votre nom dans l’URI. La SPA du commerçant le fera automatiquement lorsque vous l’utiliserez pour configurer le compte bancaire.

1.1.7. Utilisation de l’application Point de vente#

Un moyen simple pour les commerçants d’accepter les paiements GNU Taler est d’utiliser l’application de point de vente. L’application peut être installée sur un téléphone ou une tablette Android et est configurée via un simple fichier JSON sur un site web :

  • Dans les paramètres de l’application, vous devez spécifier l’URL du site Web où l’application peut télécharger les catégories, les produits et les prix à partir desquels les commandes doivent être compilées. Vous pouvez éventuellement spécifier un nom d’utilisateur et un mot de passe pour vous authentifier auprès du serveur Web.

  • La syntaxe du fichier JSON est décrite dans le manuel de l’application point de vente. Cependant, vous pouvez simplement télécharger l’exemple de fichier JSON à partir de notre documentation et l’utiliser comme point de départ.

  • Une option clé est le backend du commerçant avec la clé d’autorisation qui doit être incluse dans cette configuration JSON. Vous pouvez faire pointer l’application du point de vente vers n’importe quelle instance d’un backend marchand.

Une fois configurée, l’application de point de vente permet à l’utilisateur de sélectionner une catégorie de produits et d’ajouter rapidement des produits de cette catégorie à une commande. Vous pouvez facilement modifier la commande, et enfin utiliser le bouton « terminer » pour générer un code QR. Le code QR doit ensuite être scanné par le portefeuille GNU Taler pour initier le paiement. Plusieurs commandes peuvent être saisies simultanément, par exemple dans un restaurant où plusieurs tables sont servies en même temps.