# Instructions pour le Taler Merchant Portal

## Connexion au Taler Merchant Portal

Pour vous connecter au Taler Merchant Portal, ouvrez [my.taler-ops.ch](my.taler-ops.ch) dans votre navigateur.

![](../images/merchant/my_taler_ops_ch_qr.svg)

Saisissez le nom d’utilisateur et le mot de passe que vous avez utilisés lors de l’inscription.

Choisissez comment vous souhaitez confirmer votre connexion : en recevant un code par e-mail ou par SMS. 
Après avoir reçu le code, saisissez-le dans le champ prévu à cet effet et cliquez sur **Vérifier**.


## Gestion des commandes

Lorsqu’une cliente ou un client scanne le QR code de paiement et paie sa commande, une nouvelle commande apparaît dans
le Taler Merchant Portal. Pour consulter les commandes, choisissez **Commandes** dans le menu.

Dans l’onglet **Nouveau**, vous pouvez voir toutes les commandes en attente de paiement.

![](../images/merchant/new-order-fr.png)

\newpage

Lorsqu’une commande est payée, elle est déplacée vers l’onglet **Payée**.

Vous pouvez cliquer sur la commande pour afficher ses détails.

![](../images/merchant/paid-order-fr.png)

## Ajouter des catégories
Les catégories sont utilisées pour regrouper les produits dans l’application de point de vente. 
Si vous ne prévoyez pas d’utiliser l’application de point de vente ou la gestion des stocks, vous pouvez ignorer cette étape.

Choisissez **Catégories** dans le menu.

![](../images/merchant/category-page-fr.png)

\newpage

Pour ajouter une nouvelle catégorie, cliquez sur le bouton **+**.

![](../images/merchant/category-page-2-fr.png)

Une nouvelle page s’ouvrira. Saisissez un nom pour la nouvelle catégorie et cliquez sur **Confirmer**.

## Ajouter des produits à l’inventaire

Choisissez **Inventaire** dans le menu.

![](../images/merchant/inventory-page-fr.png)

\newpage

Pour ajouter un nouveau produit, cliquez sur le bouton **+**.

![](../images/merchant/inventory-page-2-fr.png)

Une nouvelle page s’ouvrira. Remplissez les champs suivants :

1. **Identifiant** *(obligatoire)* – identifiant unique du produit. Il peut s’agir de n’importe quelle chaîne de caractères, mais elle doit être unique pour chaque produit.
2. **Image** – l’image du produit. Elle sera utilisée dans l’application de point de vente.
3. **Nom** *(obligatoire)* – le nom du produit.
4. **Description** *(obligatoire)* – la description du produit, par exemple les informations sur les ingrédients pour les produits alimentaires.
5. **Nom de l’unite** *(obligatoire)* – l’unité de mesure du produit, par exemple « pièce », « kg », « litre », etc.
6. **Prix à l’unité** *(obligatoire)* – le prix d’une unité du produit.
7. **Stock** – le nombre d’unités actuellement en stock. Laissez ce champ vide si vous ne souhaitez pas gérer le stock via le Taler Merchant Portal.
8. **Catégories** – assigne un produit à une ou plusieurs catégories spécifiques. Les catégories aident à organiser les produits dans l’application de point de vente.

![](../images/merchant/new-product-fr.png)

## Création d’un QR code de paiement

Vous pouvez créer un QR code de paiement et soit l’imprimer vous-même, soit nous demander un autocollant avec QR code. 
Les clientes et clients peuvent scanner ce QR code pour payer leurs commandes même lorsque votre appareil marchand n’a 
pas de connexion Internet. Le QR code est réutilisable : chaque fois qu’une cliente ou un client scanne le QR code, une 
nouvelle commande est créée.

Choisissez **Modèles** dans le menu.

![](../images/merchant/template-page-fr.png)

Pour ajouter un nouveau modèle, cliquez sur le bouton **+**.

![](../images/merchant/template-page-2-fr.png)

Une nouvelle page s’ouvrira. Remplissez les champs suivants :

1. **Identifiant** *(obligatoire)* – identifiant unique du modèle. Il peut s’agir de n’importe quelle chaîne de caractères, mais elle doit être unique pour chaque modèle.
2. **Modèles** *(obligatoire)* – le nom du modèle. Vous seul verrez ce nom.
3. **Résumé de la commande** – le texte affiché à la cliente ou au client après le scan du QR code. Ce texte sera également lié à la commande dans le Taler Merchant Portal.
4. **Le résumé est éditable** – si cette option est activée, la cliente ou le client peut modifier le résumé de la commande après avoir scanné le QR code. Si elle est désactivée, la cliente ou le client ne peut pas modifier le résumé de la commande, et le texte restera identique à celui du modèle.
5. **Montant** – le montant qui sera facturé à la cliente ou au client.
6. **Le montant est modifiable** – si cette option est activée, la cliente ou le client peut modifier le montant après avoir scanné le QR code. Si elle est désactivée, la cliente ou le client ne peut pas modifier le montant, et le montant restera identique à celui du modèle.

![](../images/merchant/new-template-fr.png)

Pour imprimer le QR code, cliquez sur le bouton **Show QR** sur la page **Modèles**.

![](../images/merchant/show-template-fr.png)

Vous pouvez également envoyer le QR code à Taler Operation AG par e-mail ([print@taler-ops.ch](mailto:print@taler-ops.ch)) 
si vous souhaitez que nous imprimions et livrions des autocollants avec QR codes de paiement pour vous.

\newpage

# Instructions pour l’application de point de vente

Vous pouvez télécharger l’application de point de vente en scannant le code QR ci-dessous.

```{=latex}
\begin{center}
    \includegraphics[width=0.2\textwidth]{../images/merchant/pos-android.png}
    \hspace{0.05\textwidth}
    \includegraphics[width=0.2\textwidth]{../images/merchant/pos-android.png}
\end{center}
```

Ouvrez l’application de point de vente (POS) et saisissez le nom d’utilisateur et le mot de passe que vous avez utilisés lors de votre inscription sur [my.taler-ops.ch](my.taler-ops.ch).

Choisissez comment vous souhaitez confirmer votre connexion : en recevant un code par e-mail ou par SMS. Après avoir reçu le code, saisissez-le dans le champ et cliquez sur **OK**.

## Création d’une commande

Il existe deux façons de créer une commande :

1. Par montant
2. En sélectionnant des produits dans l’inventaire

Vous pouvez passer d’un mode à l’autre en cliquant sur l’icône du menu hamburger dans le coin supérieur gauche et en choisissant l’option appropriée dans le menu.

### Commande par montant

Pour créer une commande par montant, saisissez le montant et cliquez sur le bouton **Créer une commande (encaisser le montant)**.

Laissez le client scanner le code QR de paiement et payer la commande. Dès que la commande est payée, l’écran de confirmation s’affiche.

```{=latex}
\begin{center}
    \includegraphics[width=0.8\textwidth]{../images/merchant/pos-payment-success-fr.png}
\end{center}
```

\newpage

### Commande depuis l’inventaire

Cette option n’est utile que si vous avez ajouté des produits à l’inventaire via le Taler Merchant Portal sur [my.taler-ops.ch](my.taler-ops.ch).

Au milieu de l’écran, vous verrez les produits.

1. Catégories pour faciliter la navigation dans l’inventaire
2. Produits ajoutés à la commande, avec leur quantité et leur prix
3. Bouton permettant d’ajouter un produit personnalisé à la commande, par exemple un pourboire

**Boutons dans le coin supérieur droit :**

* Le bouton **"Effacer"** efface la commande en cours.
* Les boutons **"Précédent"** et **"Suivant"** servent à naviguer entre les commandes non terminées.
* Le bouton **"Recharger l'inventaire"** met à jour l’inventaire avec les dernières modifications du Taler Merchant Portal.

Lorsque la commande est terminée, cliquez sur le bouton **"Note"**. Le code QR de paiement s’affiche et doit être montré au client.

![](../images/merchant/pos-order-inventory-fr.png)

\newpage

## Historique des commandes

Pour afficher l’historique des commandes, cliquez sur l’icône du menu hamburger dans le coin supérieur gauche et choisissez **History** dans le menu.

Vous pouvez voir ici toutes les commandes que vous avez créées. Il existe trois types de commandes :

1. **Non payée** : Le client n’a pas encore finalisé le paiement. Scanner le code QR ne suffit pas — le client doit également vérifier et confirmer le paiement dans son portefeuille Taler. Si la commande est toujours affichée comme **Non payée**, demandez au client d’ouvrir son portefeuille, de vérifier si le paiement est encore en attente, puis d’appuyer sur **Payer**. En cliquant sur le bouton **« Afficher le paiement »**, vous pouvez afficher à nouveau le code QR de paiement si le client ne l’a pas encore scanné. Sinon, vous verrez l’écran indiquant que le paiement est en attente.
2. **Payée** : Le client a payé la commande. En cliquant sur le bouton **"Remboursement"**, vous pouvez lancer un remboursement. Pour recevoir le remboursement, le client doit scanner le code QR de remboursement généré.
3. **Remboursée** : Le client a reçu un remboursement pour la commande.

![](../images/merchant/pos-history-fr.png)