# Index des capacités

Source: https://www.qatom.ai/fr/capabilities

Tout ce qu’une personne peut faire dans Qatom, étape par étape : les acheteurs dans le chat IA, les vendeurs dans le Qatom Dashboard et les propriétaires dans la Qatom Console. Ouvrez n’importe quelle capacité pour voir à quoi elle sert, comment l’utiliser, ce que vous verrez et ce qu’il faut noter.

Qatom fait plus que ce qui est présenté ici : un twin peut contenir n’importe quel actif ou devise, et Qatom est modulaire, si bien que les builders choisissent les parties que Qatom prend en charge.

## Acheteur (dans le chat IA)

Un acheteur est une personne, ou son agent, qui trouve et paie des articles du catalogue depuis Claude, Grok, Muse ou n’importe quel client MCP.

### A1. Connectez votre IA à tout le catalogue Qatom

Ajoutez le MCP maître de Qatom comme connecteur personnalisé (Claude, Grok, Muse, n’importe quel client MCP)

Le MCP maître est la seule connexion dont un acheteur a besoin. Il donne à votre IA tous les articles publics du catalogue, ainsi que les outils de portefeuille.

- Où : Paramètres du client (Claude : Settings → Connectors)
- Qui : Tout le monde

Cómo:
1. Dans Claude, ouvrez Customize → Connectors → Add → Add custom connector.
2. Nommez-le Qatom, saisissez l’URL https://mcp.m.todaq.net/mcp et cliquez sur Continue.
3. Laissez les paramètres détectés tels quels (Authentication: Sign in now ; OAuth client: Register automatically) et cliquez sur Add.
4. Cliquez sur Connect ; la page de connexion Qatom s’ouvre (A2).
5. Dans Muse, demandez dans le chat : "I'd like to connect to the Qatom MCP at https://mcp.m.todaq.net/mcp". Muse l’affiche sous forme de carte de connecteur « Todaq » : cliquez sur Connect, lisez l’avertissement de Meta sur les connecteurs personnalisés, cliquez de nouveau sur Connect et continuez jusqu’à la page de connexion Qatom.
6. Dans Grok, utilisez grok.com/connectors → Custom avec la même URL. Dans tout autre client MCP, ajoutez la même URL comme serveur MCP distant.

Ce que vous verrez : Qatom apparaît dans la liste des connecteurs de votre client et ses outils, comme catalog_search, deviennent disponibles.

À noter :
- Utilisez l’URL du MCP maître pour acheter ; l’URL de l’instance propre d’un vendeur est une autre connexion (A22).

Link: https://www.qatom.ai/fr/capabilities#A1

### A2. Connectez-vous une seule fois avec un code par e-mail ou une passkey

Connectez-vous à Qatom (code par e-mail ou passkey) et approuvez l’accès du connecteur

En vous connectant, vous liez votre client IA à vos portefeuilles Qatom. Se connecter et s’inscrire, c’est le même parcours ; une nouvelle adresse e-mail crée un portefeuille.

- Où : Page OAuth, pay.m.todaq.net
- Qui : Tout le monde

Cómo:
1. Sur « Sign in with Qatom », saisissez votre e-mail et cliquez sur Continue. Si vous avez déjà un portefeuille Qatom, utilisez l’e-mail qui y est associé ; toute autre adresse crée un nouveau portefeuille.
2. Sur « Verify your identity », saisissez le code à 6 chiffres reçu par e-mail, ou utilisez Sign in with a passkey la prochaine fois.
3. La première fois, Qatom vous propose « Sign in faster » : cliquez sur Set up a passkey (recommandé, S11) ou sur Not now.
4. Ensuite, il vous propose « Add funds to your wallet » (A7). Rechargez maintenant ou cliquez sur Skip for now.
5. De retour dans votre client, Qatom apparaît comme connecté.

Ce que vous verrez : « Connected to Qatom » dans votre client, avec les outils Qatom dans la liste (dans Claude : sous Tool permissions).

À noter :
- Configurez d’abord une passkey (clé d’accès) (S11) : ainsi, chaque page de connexion et d’approbation ne demande qu’un seul geste au lieu d’un code par e-mail.
- Utilisez toujours le même e-mail. Une autre adresse crée un compte et des portefeuilles nouveaux et vides, et l’argent de votre ancien portefeuille n’apparaîtra pas.
- Si vous avez déjà un portefeuille Qatom, utilisez l’e-mail qui y est associé.
- Une erreur invalid_grant est un problème côté serveur ; ne relancez pas l’autorisation en boucle.

Link: https://www.qatom.ai/fr/capabilities#A2

### A3. Obtenez votre propre portefeuille et celui de votre agent

La première connexion crée le compte, le twin principal et le twin de l’agent

La première connexion configure deux portefeuilles. Qatom appelle chaque portefeuille un twin : une petite application sécurisée qui conserve votre argent en USD-TDN, un jeton en dollars américains (la Qatom Console l’affiche comme TDN ; c’est la même unité). Votre portefeuille principal (twin principal) vous appartient ; le portefeuille de l’agent (twin de l’agent) est celui où dépense votre IA.

- Où : Automático
- Qui : Tout le monde

Cómo:
1. Effectuez la première connexion (A2).
2. Demandez à votre agent : "Check my Qatom agent wallet." Il appelle agent_wallet_info.
3. Notez votre portefeuille principal (le vôtre, protégé par la connexion) et le portefeuille de votre agent (ce que dépense votre agent).

Ce que vous verrez : agent_wallet_info affiche votre portefeuille principal et le portefeuille de votre agent avec leurs soldes en USD-TDN.

À noter :
- L’agent ne peut jamais dépenser plus que ce que contient son twin, et il ne touche jamais à votre portefeuille principal ni à votre carte.
- Les offres sont réservées aux vendeurs ; pour acheter, vous n’avez jamais besoin d’une offre.
- La première fois que votre agent utilise un outil Qatom, Claude demande : Deny, Always allow ou Allow once. Choisir Always allow pour les outils en lecture seule (comme Agent wallet info) vous épargne un clic à chaque fois ; laissez les outils qui paient soumis à approbation.

Link: https://www.qatom.ai/fr/capabilities#A3

### A4. Laissez votre agent travailler dans votre compte vendeur

Ouvrez votre compte vendeur à votre chat IA (choisissez le compte que la connexion peut utiliser)

Si votre utilisateur est propriétaire d’un compte vendeur Qatom, votre agent peut le consulter et, avec votre approbation, le modifier depuis le chat. Vous choisissez d’abord quel compte vendeur il peut utiliser. C’est une autorisation distincte de la connexion à Qatom : tant que vous n’avez pas choisi, les outils de compte répondent qu’aucun compte n’est sélectionné.

- Où : account_choose
- Qui : Membre du compte

Cómo:
1. Demandez à votre agent d’utiliser votre compte vendeur Qatom ; il appelle account_choose et vous donne un lien (à usage unique, valable 15 minutes).
2. Connectez-vous avec votre passkey, ou avec votre e-mail et le code reçu, en utilisant l’adresse avec laquelle l’agent est connecté.
3. La page indique quelle application en fait la demande (par exemple "an app that calls itself Claude"), ce que l’agent verra (catalogue, portefeuilles, serveur MCP et offre) et quel compte il utilise actuellement. Choisissez le compte et cliquez sur Use this account.
4. Lorsque s’affiche "Done. The agent now uses <account>", revenez au chat. Pour changer plus tard, demandez à l’agent de choisir à nouveau.

Ce que vous verrez : L’agent peut désormais consulter le compte : son offre et sa facturation, ses portefeuilles, son catalogue, ses ventes et son serveur MCP.

À noter :
- Choisir un compte permet à l’agent de le consulter ; chaque modification vous demande tout de même une approbation (B23).
- Seuls les comptes vendeurs dont votre utilisateur est propriétaire sont proposés. Un utilisateur sans compte vendeur ne reçoit pas les outils de compte.
- Vérifiez quel compte vous avez choisi avant d’approvisionner ou d’approuver quoi que ce soit ; les approbations d’achat n’indiquent pas le portefeuille qui paie (A31).

Link: https://www.qatom.ai/fr/capabilities#A4

### A5. Vérifiez combien votre agent peut dépenser

Consultez vos portefeuilles et soldes (twin principal et twin de l’agent)

Le solde du twin de votre agent est son plafond de dépenses. Le vérifier avant d’acheter évite les achats échoués et les surprises.

- Où : agent_wallet_info, account_wallets
- Qui : Membre du compte

Cómo:
1. Demandez : "Check my Qatom wallets." L’agent appelle agent_wallet_info et affiche votre portefeuille principal et celui de l’agent.
2. Si vous vendez aussi sur Qatom, demandez les portefeuilles de votre compte professionnel ; l’agent appelle account_wallets.
3. Lisez le nom et le solde en USD-TDN de chaque portefeuille.

Ce que vous verrez : L’agent affiche chaque portefeuille avec son solde en USD-TDN.

À noter :
- Le solde peut mettre quelques minutes à refléter un achat ; consultez-le à nouveau avant de tirer des conclusions.
- Les outils account_ (account_choose, account_wallets, account_dashboard_link et les autres) apparaissent dans certaines connexions et pas dans d’autres, et ne fonctionnent qu’après le choix d’un compte professionnel. (à confirmer) Quelles connexions les affichent.

Link: https://www.qatom.ai/fr/capabilities#A5

### A6. Donnez à chaque portefeuille un nom que vous reconnaissez

Renommez un portefeuille

Avec des noms clairs, il est plus facile de savoir quel portefeuille vous approvisionnez et pour lequel vous approuvez, surtout si vous en avez plusieurs.

- Où : account_rename_wallet
- Qui : Propriétaire

Cómo:
1. Demandez à votre agent d’afficher vos portefeuilles (A5).
2. Demandez-lui d’en renommer un, en indiquant le portefeuille et le nouveau nom ; il appelle account_rename_wallet.
3. Redemandez la liste des portefeuilles pour vérifier le nouveau nom.

Ce que vous verrez : La liste des portefeuilles affiche le nouveau nom.

À noter :
- Vous pouvez aussi renommer un twin dans le Qatom Dashboard, sous Twins → twin → Name → Save name.
- Les outils account_ (account_choose, account_wallets, account_dashboard_link et les autres) apparaissent dans certaines connexions et pas dans d’autres, et ne fonctionnent qu’après le choix d’un compte professionnel. (à confirmer) Quelles connexions les affichent.

Link: https://www.qatom.ai/fr/capabilities#A6

### A7. Alimentez votre portefeuille par carte

Rechargez le portefeuille principal par carte

Votre portefeuille principal conserve l’argent que vous transférez ensuite à votre agent. Le recharger par carte est un moyen de l’approvisionner.

- Où : fund_primary_wallet → page de carte
- Qui : Propriétaire
- Argent : oui

Cómo:
1. Demandez à votre agent d’approvisionner votre portefeuille principal ; il appelle fund_primary_wallet.
2. Ouvrez la page de carte qu’il vous renvoie.
3. Remplissez vous-même la page de carte et payez.
4. Vérifiez le solde du portefeuille principal (A5).

Ce que vous verrez : Le solde en USD-TDN du portefeuille principal augmente une fois le paiement par carte effectué.

À noter :
- Juste après votre première connexion, Qatom vous propose « Add funds to your wallet » : 5, 10, 20 ou 50 dollars américains, par Apple Pay ou carte. « Load funds to agentic wallet » est coché, donc l’argent va directement dans le portefeuille de votre agent, sans transfert séparé (A8). Décochez-le pour le garder dans votre portefeuille principal.
- Votre agent ne voit ni n’utilise jamais votre carte ; c’est vous qui remplissez la page.
- Si la page de carte renvoie une erreur sur un nouveau portefeuille, approvisionnez-le autrement (A32).
- Les recharges par carte entraînent des frais. (à confirmer) Si les frais s’ajoutent au débit ou sont déduits du montant.

Link: https://www.qatom.ai/fr/capabilities#A7

### A8. Donnez à votre agent un petit budget

Transférez des fonds du portefeuille principal vers le twin de l’agent

Votre agent ne peut dépenser que ce que contient son propre twin. Lui transférer un petit montant fixe une limite stricte à ce qu’il peut acheter.

- Où : transfer_to_agent → approbation
- Qui : Propriétaire
- Argent : oui

Cómo:
1. Demandez à votre agent de transférer un montant de votre portefeuille principal vers le portefeuille de l’agent ; il appelle transfer_to_agent.
2. Il vous donne un lien d’approbation et une notification dans votre application TODAQ (Qatom Authenticator). Vérifiez le compte, le portefeuille et le montant (A31), puis approuvez.
3. Prévenez l’agent que vous avez approuvé ; il rappelle l’outil avec l’id d’approbation pour terminer. Rien ne bouge tant qu’il ne l’a pas fait.
4. Vérifiez le solde du portefeuille de l’agent avec agent_wallet_info.

Ce que vous verrez : Le solde du twin de l’agent augmente du montant transféré, et celui du principal diminue d’autant.

À noter :
- Approvisionnez l’agent comme si vous lui donniez un peu d’argent liquide ; il ne peut pas accéder à votre portefeuille principal.

Link: https://www.qatom.ai/fr/capabilities#A8

### A9. Laissez passer les petits achats sans vous demander

Définissez le seuil d’approbation automatique des achats de l’agent

Les achats inférieurs ou égaux à votre seuil d’approbation automatique sont payés sans vous demander. Au-delà du seuil, vous approuvez chacun d’eux.

- Où : Fenêtre d’approbation du paiement (web), ou l’application TODAQ (Qatom Authenticator)
- Qui : Propriétaire

Cómo:
1. Lancez n’importe quel achat de l’agent qui demande une approbation.
2. Dans la fenêtre d’approbation du paiement, définissez votre seuil d’approbation automatique en USD-TDN.
3. Réglez-le sur 0 si vous voulez approuver chaque achat.
4. Définissez le seuil dans la fenêtre, puis approuvez ou refusez l’achat en cours. (à confirmer) Les noms exacts des commandes.

Ce que vous verrez : Le prochain achat inférieur ou égal au seuil aboutit sans demander d’approbation.

À noter :
- Fixez le seuil en tenant compte des nouvelles tentatives : l’approbation automatique laisse aussi passer un appel répété, donc une nouvelle tentative peut vous être facturée deux fois (A28).
- Vous seul pouvez modifier le seuil ; le jeton d’un agent est refusé.
- Le seuil s’applique aussi aux paniers : un panier dont le total est dans la limite est payé immédiatement, sans approbation.

Link: https://www.qatom.ai/fr/capabilities#A9

### A10. Trouvez dans le catalogue ce dont votre agent a besoin

Recherchez dans le catalogue par besoin ou par nom

La recherche est le moyen par lequel un agent trouve des articles à acheter. Elle renvoie tous les articles publics correspondants, avec leur prix et leur vendeur.

- Où : catalog_search
- Qui : Tout le monde

Cómo:
1. Demandez en termes simples : "Search the Qatom catalog for weather."
2. L’agent appelle catalog_search avec votre requête.
3. Demandez-lui de filtrer ou de passer à la page suivante s’il y a beaucoup de résultats.

Ce que vous verrez : Une liste d’articles, chacun avec son id, son nom, sa description, son prix, son vendeur et son schéma d’entrée.

À noter :
- Un article sans ligne vendeur (ou avec le vendeur None) provient d’un vendeur qui n’a pas défini de nom commercial ; vous ne pouvez donc pas savoir à qui il appartient.
- Le catalogue contient aussi des publications de test ; vérifiez le vendeur et la description avant de payer.
- Les articles privés n’apparaissent pas dans la recherche principale ; ils se trouvent uniquement dans l’instance propre du vendeur (A22).

Exemple : Recherchez "Qatom Demo" pour trouver les articles de commentaires, la skill de guide pour vendeurs et la vidéo de la station spatiale de la boutique de démonstration.

Link: https://www.qatom.ai/fr/capabilities#A10

### A11. Sachez ce que vous recevez avant de payer

Consultez un article : prix, vendeur, entrées, description, read-me

La publication et le read-me du vendeur indiquent ce que renvoie un article, combien il coûte et quelles entrées il reçoit.

- Où : Résultat de catalog_search, llms.txt du vendeur
- Qui : Tout le monde

Cómo:
1. Demandez à votre agent de vous montrer un article des résultats de recherche.
2. Vérifiez le prix en USD-TDN, le nom du vendeur et les entrées du schéma.
3. Ouvrez le lien vers llms.txt dans la description pour voir des exemples et la signification des erreurs.
4. Cherchez un article gratuit de vérification ou d’aperçu à côté de l’article payant.

Ce que vous verrez : Votre agent vous explique le prix, le vendeur, les entrées et ce que renvoie l’article.

À noter :
- Les prix s’affichent avec jusqu’à trois décimales ; le prix payant le plus bas est de 0.001 USD-TDN. Les résultats des outils Qatom et les reçus affichent toujours trois décimales : un article gratuit apparaît donc comme 0.000 et 2 apparaît comme 2.000.

Exemple : La boutique Qatom Demo publie son read-me sur https://qatom-demo.agentkepler.tech/llms.txt, avec chaque article, son prix et ses entrées.

Link: https://www.qatom.ai/fr/capabilities#A11

### A12. Utilisez les articles gratuits sans frais

Appelez un article gratuit

Les articles gratuits coûtent 0 et renvoient leur réponse dans le reçu. Les vendeurs les utilisent pour des vérifications, des aperçus et des commentaires.

- Où : agent_checkout, gratuit
- Qui : Acheteur connecté

Cómo:
1. Trouvez un article gratuit avec catalog_search.
2. Demandez à votre agent de l’appeler ; il utilise agent_checkout avec l’id de l’article et les arguments.
3. Lisez la réponse dans le reçu.

Ce que vous verrez : Un reçu de 0 USD-TDN contenant la réponse du vendeur.

À noter :
- Un article gratuit peut tout de même vous demander une approbation avant de s’exécuter. Approuver ne déplace aucun argent ; cette étape sera simplifiée.

Exemple : Qatom Demo: customer feedback est gratuit et renvoie un id de référence. search challenges, spectate et leaderboard de Centaur League sont également gratuits.

Link: https://www.qatom.ai/fr/capabilities#A12

### A13. Laissez votre agent acheter et utiliser un article

Achetez un article payant depuis le twin de l’agent

agent_checkout paie depuis le twin de l’agent et renvoie la réponse du vendeur dans la même étape. Votre agent vous demande votre accord avant de payer.

- Où : agent_checkout
- Qui : Acheteur connecté
- Argent : oui

Cómo:
1. Choisissez l’article et les entrées (A10, A11).
2. Demandez à votre agent de l’acheter ; il confirme d’abord le prix avec vous.
3. L’agent appelle agent_checkout avec l’id de l’article et les arguments.
4. Dans la limite de votre seuil d’approbation automatique, le paiement est immédiat. Au-delà, l’agent vous donne un lien d’approbation et attend ; vous approuvez, vous prévenez l’agent et il rappelle pour terminer (A14).

Ce que vous verrez : Un reçu avec un id de transaction et la réponse du vendeur, et un solde réduit sur le twin de l’agent.

À noter :
- "Invalid payment request" peut signifier que l’endpoint du vendeur a refusé l’appel ; consultez l’historique de votre portefeuille (A28) pour voir si vous avez été débité, puis interrogez le vendeur (A27).
- Le solde du portefeuille de l’agent est une limite stricte ; rechargez-le d’abord si nécessaire (A8).
- Pour acheter plusieurs articles à la fois, utilisez un panier (A33).

Exemple : Achat de Qatom Demo: seller guide skill (0.005 USD-TDN) : renvoie un lien de téléchargement valable 15 minutes, la version, le SHA-256 et les étapes d’installation.

Link: https://www.qatom.ai/fr/capabilities#A13

### A14. Donnez votre accord avant le paiement des achats plus importants

Approuvez un achat au-delà du seuil d’approbation automatique

Au-delà de votre seuil d’approbation automatique, rien n’est payé tant que vous n’avez pas approuvé. Vous gardez ainsi le contrôle de chaque achat plus important.

- Où : Page d’approbation web, ou l’app TODAQ (Qatom Authenticator)
- Qui : Propriétaire
- Argent : oui

Cómo:
1. Lorsque votre agent vous le demande, ouvrez le lien d’approbation qu’il vous donne, ou la notification sur votre téléphone dans l’app TODAQ (Qatom Authenticator).
2. Vérifiez que vous êtes connecté au compte avec lequel vous voulez payer (A4) ; vérifiez ensuite l’article, le vendeur payé et le montant (A31).
3. Touchez Approve, ou Dismiss pour refuser.
4. Prévenez l’agent que vous avez approuvé. Il rappelle avec l’id d’approbation et vous montre le reçu ; rien ne se passe tant que vous ne l’avez pas prévenu.

Ce que vous verrez : La page d’approbation confirme votre décision et l’agent affiche le reçu, ou signale le refus.

À noter :
- Les liens d’approbation expirent au bout d’environ 15 minutes et appartiennent à un seul compte. Si un lien expire, demandez à l’agent de relancer l’achat ; l’approbation précédente n’est plus valable.

Link: https://www.qatom.ai/fr/capabilities#A14

### A15. Conservez l’id de transaction de chaque achat

Lisez le résultat et le reçu (id de transaction)

Le reçu contient ce que vous avez acheté et la réponse du vendeur. Son id de transaction est celui que vous indiquez dans toute demande de remboursement.

- Où : Reçu de agent_checkout
- Qui : Acheteur

Cómo:
1. Demandez à votre agent de vous montrer le reçu complet.
2. Notez l’id de transaction, l’article, le montant et la réponse du vendeur.
3. Conservez l’id de transaction en lieu sûr.

Ce que vous verrez : Un reçu avec l’id de transaction, l’article, le montant payé et la réponse du vendeur.

À noter :
- La ligne du reçu provient du Descriptor du vendeur, qui peut différer du nom de l’article.

Exemple : Les reçus de Qatom Demo comportent un résumé d’une ligne et un lien de visionnage, comme "Watch the stream" pour l’article vidéo.

Link: https://www.qatom.ai/fr/capabilities#A15

### A16. Payez par carte sans créer de portefeuille

Achetez en tant qu’invité par carte, sans portefeuille

Le paiement en tant qu’invité permet à une personne de payer un article par carte. Il convient aux achats ponctuels lorsqu’il n’y a pas de portefeuille.

- Où : guest_checkout → page de paiement, vérification de l’e-mail
- Qui : Tout le monde
- Argent : oui

Cómo:
1. Donnez à votre agent les entrées de l’article ; il les recueille dans le chat puis appelle guest_checkout pour obtenir un lien de paiement.
2. Ouvrez la page de paiement, puis saisissez et vérifiez votre e-mail pour recevoir un reçu sécurisé avec preuve d’achat.
3. Saisissez vous-même les données de votre carte et payez.

Ce que vous verrez : La page de paiement confirme le paiement. (à confirmer) Où le résultat de l’article est livré.

À noter :
- Les paiements par carte ont un minimum d’environ $0.50 ; pour les petits articles, mieux vaut donc utiliser des portefeuilles d’agent.

Link: https://www.qatom.ai/fr/capabilities#A16

### A33. Regroupez plusieurs articles dans un panier

Mettez plusieurs articles dans un panier et modifiez-le avant de payer

Un panier contient plusieurs articles, d’un ou de plusieurs vendeurs, pour que vous payiez une seule fois. Vous pouvez modifier les quantités et les entrées, ou retirer des articles, jusqu’au début du paiement.

- Où : Chat IA (connecteur Qatom)
- Qui : Acheteur, ou son agent

Cómo:
1. Demandez simplement les articles que vous voulez, par exemple "Get me the space station video and two copies of the seller guide skill."
2. Répondez aux questions de l’agent sur les entrées de chaque article ; il ajoute chacun avec cart_add_item (jusqu’à 20 exemplaires d’un même article).
3. Demandez à voir le panier ; l’agent appelle cart_view et affiche chaque ligne, sa quantité, son prix et le total.
4. Changez d’avis quand vous voulez : l’agent utilise cart_update_item pour une quantité ou des entrées, et cart_remove_item pour retirer une ligne.

Ce que vous verrez : Un récapitulatif du panier avec chaque article, sa quantité et son prix, et le total en USD-TDN.

À noter :
- Chaque exemplaire d’un article est un achat distinct avec son propre id de transaction.
- Les numéros de ligne se suivent d’un panier à l’autre ; l’agent doit donc consulter le panier (cart_view) avant de modifier une ligne.
- Pour abandonner tout le panier, demandez à l’agent de l’abandonner (cart_discard) ; un panier dont le paiement a déjà commencé ne peut pas être abandonné.

Exemple : Le 12 octobre, un panier contenait de Qatom Demo: customer feedback (gratuit), la skill de guide pour vendeurs (0.005) et la vidéo de la station spatiale (0.01, avec un lien de deux heures) : total 0.015.

Link: https://www.qatom.ai/fr/capabilities#A33

### A34. Payez tout le panier en une fois

Payez un panier : depuis le portefeuille de l’agent avec une seule approbation, ou par carte via un seul lien

Un panier se paie en une seule fois : depuis le portefeuille de votre agent avec une seule approbation pour l’ensemble, ou par carte via un seul lien de paiement. Chaque article est ensuite transmis à son vendeur avec ses entrées.

- Où : Chat IA (connecteur Qatom)
- Qui : Acheteur, ou son agent
- Argent : oui

Cómo:
1. Choisissez le mode de paiement. Portefeuille de l’agent : l’agent appelle cart_pay. Carte : l’agent appelle cart_checkout et vous donne un seul lien pour l’ensemble.
2. Portefeuille de l’agent dans la limite de votre seuil d’approbation automatique : le paiement est immédiat. Au-delà du seuil : vous approuvez tout le panier une fois (A14, A31), vous prévenez l’agent et il rappelle cart_pay avec l’id d’approbation.
3. Carte : ouvrez le lien, vérifiez les articles et le total, et payez vous-même. Le panier peut encore être modifié jusqu’au début du paiement, et le lien reflète la modification.
4. Lisez la réponse de chaque article dans la réponse de l’agent : liens, fichiers ou confirmations.

Ce que vous verrez : L’agent affiche le résultat de chaque article (par exemple un lien de stream, un lien de téléchargement et une référence de commentaires) et un seul e-mail de reçu liste chaque article et le total.

À noter :
- La réponse de chaque article n’arrive qu’une fois, dans cette réponse. Demandez à l’agent de vous transmettre chaque lien immédiatement ; si vous le redemandez, il ne revient pas.
- Si un prix change après votre approbation, rien de plus n’est débité et la question vous est posée à nouveau.
- Un long panier peut nécessiter plus d’un appel ; l’agent continue avec la même approbation.
- Pour vous arrêter en cours de route, demandez à l’agent de clôturer le panier (cart_finish) : vous conservez ce qui a déjà été acheté, le reste est annulé et vous recevez un reçu.
- L’e-mail de reçu indique l’id du panier ; l’id de transaction de chaque article figure dans la réponse de l’agent.

Exemple : 0.015 payé depuis le portefeuille de l’agent le 12 octobre, dans la limite d’un seuil d’approbation automatique de 1 USD-TDN, donc sans approbation : la référence de commentaires, un téléchargement de la skill valable 15 minutes et un lien de stream de deux heures sont arrivés dans une seule réponse.

Link: https://www.qatom.ai/fr/capabilities#A34

### A17. Conservez un reçu par e-mail de chaque achat

Recevez par e-mail le reçu avec preuve d’achat

Chaque achat direct, par agent ou par paiement invité par carte, envoie un reçu par e-mail. Vous disposez ainsi d’une trace hors du chat pour votre comptabilité et vos demandes de remboursement.

- Où : Correo
- Qui : Acheteur

Cómo:
1. Consultez votre boîte de réception après un achat.
2. Ouvrez l’e-mail de reçu de Qatom.
3. Conservez-le avec l’id de transaction du reçu du chat.

Ce que vous verrez : Un e-mail de reçu avec les détails de l’achat.

Link: https://www.qatom.ai/fr/capabilities#A17

### A22. Accédez aux articles privés et mis en avant d’un vendeur

Connectez l’instance MCP propre d’un vendeur (articles privés et mis en avant)

Chaque vendeur dispose de sa propre instance MCP. Les articles privés ne sont accessibles que là, et les articles mis en avant (Featured) apparaissent comme des outils nommés.

- Où : Paramètres du client, URL MCP du vendeur
- Qui : Tout le monde

Cómo:
1. Demandez au vendeur l’URL de son MCP, par exemple sur son site web ou dans son llms.txt ; elle se termine par .mcp.m.todaq.net/mcp, sauf s’il utilise son propre domaine.
2. Ajoutez-la comme connecteur personnalisé dans votre client, comme dans A1.
3. Connectez-vous si demandé (code par e-mail ou passkey, comme dans A2).
4. Demandez la liste des outils pour voir les articles mis en avant du vendeur.

Ce que vous verrez : Les articles mis en avant du vendeur apparaissent comme des outils nommés dans votre client.

À noter :
- Les articles privés ne figurent pas dans la recherche principale, et agent_checkout via le MCP principal indique qu’ils sont introuvables.
- (à confirmer) Si les acheteurs se connectent à l’instance d’un vendeur de la même façon qu’au MCP principal.

Link: https://www.qatom.ai/fr/capabilities#A22

### A23. Interagissez avec un tableau de bord en direct dans le chat

Utilisez une vue interactive MCP App (tableau de bord, carte, lecteur)

Certains vendeurs ajoutent une vue en direct à leurs outils gratuits : vous obtenez ainsi un tableau de bord, une carte ou un lecteur dans le chat. L’argent reste dans Qatom.

- Où : Serveur MCP gratuit du vendeur, p. ex. centaurleague.games/mcp
- Qui : Tout le monde

Cómo:
1. Ajoutez le serveur MCP gratuit du vendeur comme second connecteur personnalisé, p. ex. https://centaurleague.games/mcp (sans connexion).
2. Demandez une vue, par exemple "Spectate Centaur League" ou l’affichage d’une partie.
3. Utilisez la vue : déplacez des pièces, proposez la nulle ou abandonnez sur l’échiquier.
4. Laissez les étapes de paiement, comme l’inscription, dans le MCP de Qatom.

Ce que vous verrez : Un tableau de bord ou une carte interactive s’ouvre dans la conversation.

À noter :
- Les MCP Apps (tableaux de bord, cartes et lecteurs dans le chat) fonctionnent aujourd’hui dans Claude, ChatGPT et Hermes. Grok et Muse ne les prennent pas encore en charge.
- Aucun achat ne démarre depuis une vue ; vous approuvez l’argent dans le flux propre de Qatom.

Exemple : view_match et spectate de Centaur League ouvrent un échiquier dans le chat ; l’agent recommande un coup et la personne le joue.

Link: https://www.qatom.ai/fr/capabilities#A23

### A24. Ouvrez votre lien de stream et regardez

Regardez un stream vidéo que vous avez acheté

Un achat vidéo renvoie un lien de lecteur avec sa propre clé à durée limitée. Vous regardez dans le navigateur jusqu’à l’expiration de la clé.

- Où : player_url du reçu
- Qui : Acheteur

Cómo:
1. Achetez l’article vidéo (A13) ; vous pouvez définir ttl_seconds pour la durée de validité de la clé.
2. Ouvrez le lien du lecteur figurant sur le reçu (il apparaît comme "Watch the stream").
3. Laissez le lecteur choisir la qualité ; il s’adapte entre 1080p, 720p et 480p.

Ce que vous verrez : La vidéo est lue dans le lecteur du navigateur, l’image de couverture s’affichant d’abord.

À noter :
- La clé est propre à chaque achat : toute personne disposant du lien peut regarder jusqu’à son expiration.
- Un lien expiré ou modifié renvoie 403 ; achetez à nouveau pour regarder après l’expiration.

Exemple : Qatom Demo: space station video (0.01 USD-TDN) diffuse une visite du domaine public de la NASA ; ttl_seconds va de 60 à 86400, avec 3600 par défaut.

Link: https://www.qatom.ai/fr/capabilities#A24

### A25. Dites à un vendeur ce qui a fonctionné et ce qui n’a pas fonctionné

Envoyez des commentaires à un vendeur

Les vendeurs ajoutent par défaut un article gratuit de commentaires clients. C’est le moyen direct de contacter le vendeur.

- Où : Article gratuit de commentaires du vendeur
- Qui : Tout le monde

Cómo:
1. Cherchez dans le catalogue l’article "customer feedback" du vendeur.
2. Demandez à votre agent d’envoyer votre message avec agent_checkout ; c’est gratuit.
3. Ajoutez votre e-mail pour recevoir une réponse, et un id de commande ou d’article s’il s’agit d’un achat.
4. Conservez l’id de référence renvoyé.

Ce que vous verrez : Un reçu de 0 avec un id de référence confirmant que le vendeur a reçu votre message.

À noter :
- Les messages comptent de 3 à 2 000 caractères.
- Une réponse not_configured (503) signifie que le vendeur n’a pas encore configuré les commentaires ; passez à l’étape suivante d’A27.

Exemple : Qatom Demo: customer feedback accepte message (obligatoire), from_email et subject_ref, et renvoie un id de référence.

Link: https://www.qatom.ai/fr/capabilities#A25

### A26. Passez du chat au tableau de bord web

Ouvrez le tableau de bord web de Qatom depuis le chat

Certaines tâches ne se font que sur le web : secrets, clés d’API, en-têtes de requête d’un article, votre carte, votre abonnement, un domaine personnalisé. L’agent vous donne un lien vers la bonne page du Qatom Dashboard.

- Où : account_dashboard_link
- Qui : Membre du compte

Cómo:
1. Demandez à votre agent la page dont vous avez besoin ; il appelle account_dashboard_link avec cette page (pour les en-têtes d’un article, avec l’id de l’article).
2. Ouvrez le lien dans votre navigateur et connectez-vous si demandé.
3. Vérifiez que le Dashboard affiche le compte voulu avant de modifier quoi que ce soit.

Ce que vous verrez : Le Qatom Dashboard s’ouvre sur votre compte sur dashboard.qatom.ai.

À noter :
- Ne collez jamais un secret, une clé ou un numéro de carte dans le chat ; le lien existe pour que vous les saisissiez vous-même dans le Dashboard.
- Le Dashboard ouvre le dernier compte que vous y avez utilisé, qui n’est pas forcément celui que vous avez demandé.
- Les outils account_ (account_choose, account_wallets, account_dashboard_link et les autres) apparaissent dans certaines connexions et pas dans d’autres, et ne fonctionnent qu’après le choix d’un compte professionnel. (à confirmer) Quelles connexions les affichent.

Link: https://www.qatom.ai/fr/capabilities#A26

### A27. Interrogez d’abord le vendeur, puis le support TODAQ

Demandez un remboursement ou signalez un problème de débit

Les paiements sont réglés immédiatement, et les remboursements sont décidés par le vendeur. Ce parcours transmet votre demande à la bonne personne.

- Où : Article de commentaires du vendeur, puis hello@qatom.ai
- Qui : Acheteur

Cómo:
1. Copiez l’id de transaction depuis la réponse de l’agent, le reçu ou l’historique de votre portefeuille.
2. Appelez l’article gratuit de commentaires clients du vendeur avec l’id de transaction et ce qui n’a pas fonctionné.
3. Si le vendeur n’en a pas, ou sans réponse sous un ou deux jours, écrivez à hello@qatom.ai avec l’id de transaction, l’article et ce qui s’est passé.
4. Surveillez votre portefeuille pour un éventuel virement de remboursement.

Ce que vous verrez : Un id de référence de l’article de commentaires ; tout remboursement arrive sous forme de virement sur le portefeuille qui a payé.

À noter :
- Aucun délai de remboursement n’est garanti.
- Pour un article acheté dans un panier, indiquez l’id de transaction propre à cet article, qui figure dans la réponse de l’agent ; l’e-mail de reçu indique l’id du panier.
- Un article gratuit de commentaires de Team Kepler (S10) arrive bientôt ; en attendant qu’il soit dans le catalogue, utilisez hello@qatom.ai.

Exemple : Qatom Demo: customer feedback accepte subject_ref, où vous indiquez l’id de transaction.

Link: https://www.qatom.ai/fr/capabilities#A27

### A28. Vérifiez avant de répéter un appel de paiement

Réessayez avec prudence : vérifiez le reçu et le portefeuille avant de répéter un appel de paiement ; une nouvelle tentative est un nouveau débit, même avec l’approbation automatique

Si la réponse est coupée, l’achat a peut-être quand même eu lieu. Une nouvelle tentative est un nouveau débit : vérifiez d’abord.

- Où : Comportement de l’agent
- Qui : Agent de l’acheteur
- Argent : oui

Cómo:
1. Demandez à l’agent le dernier reçu et son id de transaction.
2. Consultez le solde du twin de l’agent, en lui laissant quelques minutes pour se mettre à jour.
3. Ne réessayez que s’il n’y a pas de reçu et que le solde n’a pas baissé.
4. Si vous avez été débité deux fois, suivez A27.

Ce que vous verrez : Un reçu pour chaque achat que vous vouliez faire, et un solde qui concorde.

À noter :
- L’approbation automatique laisse passer une nouvelle tentative sans demander : les doubles débits passent donc sans avertissement.
- Un appel que le vendeur rejette peut quand même être facturé.

Link: https://www.qatom.ai/fr/capabilities#A28

### A29. Voyez comment sont notées les publications d’un vendeur

Vérifiez la note d’un vendeur avant d’acheter (quand les notes Pirate Kepler seront actives)

Un service de notation évalue les publications du catalogue pour que les acheteurs puissent juger un vendeur avant de payer.

- Où : Outil de notes et d’avis
- Qui : Tout le monde

Cómo:
1. Cherchez dans le catalogue l’outil de notes et d’avis.
2. Demandez à votre agent de consulter la note du vendeur.
3. Lisez la note à côté de la publication de l’article.

Ce que vous verrez : La note du vendeur apparaît à côté de l’article.

À noter :
- (à confirmer) Les notes Pirate Kepler sont sur le point d’être lancées ; le nom de l’outil et ce qu’il renvoie restent à confirmer.

Link: https://www.qatom.ai/fr/capabilities#A29

### A30. Approuvez les achats depuis votre téléphone

Installez l’app TODAQ (Qatom Authenticator) et connectez-vous au bon twin

L’app TODAQ (Qatom Authenticator) vous permet d’approuver les achats de votre agent sur votre téléphone. Elle doit être connectée au compte qui paie.

- Où : Teléfono
- Qui : Propriétaire
- Secret : nécessite un secret

Cómo:
1. Installez l’app TODAQ (Qatom Authenticator) sur votre téléphone.
2. Connectez-vous avec le même compte que celui que vous utilisez dans le chat.
3. Vérifiez qu’elle affiche le portefeuille pour lequel vous approuvez des achats (A31).

Ce que vous verrez : L’app affiche votre compte et votre portefeuille, prête pour les approbations.

Link: https://www.qatom.ai/fr/capabilities#A30

### A31. Vérifiez l’article, le vendeur et le prix avant d’approuver

Vérifiez ce que vous approuvez : article, vendeur, quantité et prix

Si vous avez plusieurs comptes ou portefeuilles, approuver dans le mauvais dépense le mauvais argent. Une vérification rapide l’évite.

- Où : Page d’approbation / app
- Qui : Propriétaire
- Argent : oui

Cómo:
1. Ouvrez la demande Purchase Approval (la page web, ou l’app TODAQ, aussi appelée Qatom Authenticator).
2. Lisez le nom de l’article, "Payment to" (le vendeur), la quantité et le prix.
3. Si quelque chose ne va pas, touchez Dismiss.
4. N’approuvez que lorsque tout correspond à ce que vous avez demandé.

Ce que vous verrez : Purchase Approval affiche Purchase Request, l’article avec "Payment to <seller>", Qty et le prix, avec Dismiss et Approve.

À noter :
- L’approbation n’indique pas le portefeuille qui paie : assurez-vous donc d’être connecté au compte avec lequel vous vouliez payer (A4).
- Dans un panier, une seule approbation couvre tous les articles aux prix affichés ; vérifiez le total et la liste des articles.

Link: https://www.qatom.ai/fr/capabilities#A31

### A32. Placez les premiers fonds sur un nouveau portefeuille

Approvisionnez un nouveau portefeuille (recharge par carte, ou transfert depuis un autre twin)

Un nouveau portefeuille démarre vide. Vous pouvez l’approvisionner par carte, ou lui envoyer des USD-TDN depuis un twin que vous possédez déjà.

- Où : fund_primary_wallet, Console Send
- Qui : Propriétaire
- Argent : oui

Cómo:
1. Essayez d’abord une recharge par carte avec fund_primary_wallet (A7).
2. Ou, dans la Qatom Console sur console.todaq.net, ouvrez un twin approvisionné et cliquez sur Send.
3. Choisissez la devise, saisissez le montant et l’URL du twin du nouveau portefeuille, ajoutez une note, puis laissez le propriétaire cliquer sur Transfer.
4. Ou demandez des TDN avec Purchase TDN → Buy TDN et payez par virement bancaire (wire) ou ACH.

Ce que vous verrez : Le solde du nouveau portefeuille affiche les USD-TDN reçus.

À noter :
- Certains nouveaux portefeuilles ont renvoyé une erreur (500) lors de la recharge par carte ; dans ce cas, utilisez un transfert.
- Send exige le rôle Transfer sur le twin qui envoie ; ne relancez jamais un transfert déjà accepté.
- Les demandes Buy TDN vont de 0.50 à 100 USD et sont finalisées à la réception de votre paiement.

Link: https://www.qatom.ai/fr/capabilities#A32

## Vendeur (dans le Qatom Dashboard)

Un vendeur transforme une API, un dataset, un stream ou un jeu en articles de catalogue que les agents peuvent trouver et payer, à l’aide du Qatom Dashboard. Les capacités suivent l’ordre dans lequel un nouveau vendeur les rencontre.

### B1. Choisissez une chose pour laquelle les agents paieront

Choisissez le premier cas d’usage et le prix

Commencez par un article qui répond en un seul appel et coûte peu à servir. Un premier article petit et clair est plus facile à tester, à tarifer et à expliquer.

- Où : Skill de guide du vendeur / dépôt de cas d’usage
- Qui : Vendeur

Cómo:
1. Installez la skill de guide du vendeur dans votre agent : npx skills add StarwaterHeaven/qatom-seller-guide --skill qatom-seller-guide.
2. Répondez à ses questions : qu’avez-vous de calculé, d’actuel, d’unique ou de fastidieux, et qui le demanderait souvent ?
3. Indiquez combien vous coûte la production d’une réponse.
4. Choisissez un ou deux premiers articles dans la bibliothèque de cas d’usage, chacun avec une vérification gratuite associée.
5. Fixez un prix par appel en USD-TDN : 0 pour gratuit, sinon au moins 0.001, avec trois décimales au plus.

Ce que vous verrez : Le guide donne une ligne par article choisi : ce qu’il renvoie, qui l’achète et une idée de prix.

À noter :
- Un article de catalogue a un seul prix ; plusieurs prix signifient plusieurs articles.
- Le checkout invité par carte a un minimum d’environ $0.50 : les articles à moins de 50 cents sont donc destinés aux portefeuilles d’agents.
- Vous pouvez vous inscrire (B34) avant ou après la construction ; le guide construit d’abord pour que votre endpoint soit prêt quand vous créez les articles.

Exemple : La boutique Qatom Demo vend une vidéo à 0.01 et une skill d’agent à 0.005, à côté d’un article de commentaires gratuit.

Link: https://www.qatom.ai/fr/capabilities#B1

### B2. Placez votre produit derrière un endpoint HTTPS

Construisez et hébergez l’endpoint (modèle de Worker)

Qatom appelle votre endpoint après le règlement de chaque paiement. Vous l’hébergez ; le modèle de Worker est le moyen le plus rapide de commencer.

- Où : Hébergement propre du vendeur
- Qui : Vendeur

Cómo:
1. Partez du modèle de Worker : il lit un catalog.json, valide les entrées, protège la route payante, sert /llms.txt et exécute l’article de commentaires.
2. Donnez à chaque article un ID permanent en minuscules, des entrées avec nom, type et plage, et un résumé d’une phrase dans chaque réponse.
3. Renvoyez chaque erreur avec un code, un message simple et une étape suivante (par exemple unknown_parameter 400, bad_value 400).
4. Déployez-le sur votre hébergement et appelez-le directement pour le tester, avant de le tester via Qatom.

Ce que vous verrez : Un appel direct à une route gratuite renvoie du JSON avec ok: true et un résumé lisible.

À noter :
- N’acceptez jamais de SQL, de code ou de query strings bruts comme entrées ; convertissez-les en entrées nommées.
- Qatom peut signaler un appel échoué comme une erreur de paiement générique : testez donc d’abord l’endpoint directement.
- Ne mettez pas de secrets dans l’URL de l’endpoint ; d’autres utilisateurs du tableau de bord peuvent la voir.

Exemple : La boutique Qatom Demo est un Cloudflare Worker derrière trois articles de catalogue ; son URL de base https://qatom-demo.agentkepler.tech renvoie le nom de la boutique et le lien vers le read-me.

Link: https://www.qatom.ai/fr/capabilities#B2

### B3. Faites en sorte que la route de paiement ne réponde qu’à Qatom

Configurez les secrets de l’endpoint (route secrète, jeton de fulfilment)

La route payante doit rejeter tout appel qui ne vient pas de Qatom. Un jeton de fulfilment, vérifié à chaque appel, y parvient.

- Où : Coffre de secrets de l’hébergement
- Qui : Vendeur
- Secret : nécessite un secret

Cómo:
1. Générez le jeton sur votre propre machine : openssl rand -hex 24.
2. Enregistrez-le dans le coffre de secrets de votre hébergement (wrangler secret put QATOM_FULFILMENT_TOKEN) et dans un gestionnaire de mots de passe.
3. Faites vérifier par l’endpoint l’en-tête Authorization avec une comparaison à temps constant, et répondre 404 quand il manque ou est incorrect.
4. Ajoutez éventuellement une route secrète (/paid/<SERVICE_PATH>/...) comme couche supplémentaire ; les autres routes répondent 404.

Ce que vous verrez : Un appel direct sans l’en-tête reçoit 404 ; le même appel avec l’en-tête reçoit la réponse.

À noter :
- Ne collez jamais un secret dans un chat, un document, un ticket ou une fiche.
- Une route secrète reste dans l’URL de l’endpoint, que d’autres utilisateurs du tableau de bord peuvent voir ; l’en-tête est la protection principale.
- Ne renvoyez jamais l’URL ou les en-têtes de la requête dans une réponse ; changez tout ce qui fuite.

Exemple : Les routes payantes de la boutique Qatom Demo exigent à la fois une route secrète et un en-tête Authorization marqué Sensitive, que Qatom envoie à chaque appel de fulfilment.

Link: https://www.qatom.ai/fr/capabilities#B3

### B4. Indiquez aux agents comment vous appeler et vous payer

Rédigez et servez le read-me pour agents (llms.txt)

llms.txt est un read-me en Markdown pour les modèles de langage, à la racine de votre site. Les agents qui trouvent vos articles le consultent avant d’appeler.

- Où : Site du vendeur
- Qui : Vendeur

Cómo:
1. Générez-le à partir de catalog.json, ou du catalogue public en direct (GET https://pay.m.todaq.net/v4/catalog/items) ; ne l’écrivez jamais à la main.
2. Incluez : nom du vendeur, un court résumé, un horodatage Generated, comment appeler (catalog_search puis agent_checkout), des exemples commentés et le tableau du catalogue.
3. Ajoutez les schémas d’entrée, chaque code d’erreur avec son étape suivante, et des ressources, dont votre article de commentaires.
4. Servez-le sur /llms.txt sur votre propre domaine et indiquez cette URL dans la description de chaque article.

Ce que vous verrez : En ouvrant /llms.txt sur votre site, on voit l’horodatage de génération et un tableau de vos articles avec leurs prix.

À noter :
- Régénérez-le à chaque modification du catalogue pour qu’il ne s’écarte jamais de ce qui est publié.

Exemple : La boutique Qatom Demo génère https://qatom-demo.agentkepler.tech/llms.txt elle-même ; Centaur League régénère son read-me toutes les 10 minutes à partir du catalogue en direct.

Link: https://www.qatom.ai/fr/capabilities#B4

### B34. Créez votre compte vendeur et votre serveur MCP

Inscrivez un nouveau compte vendeur : code par e-mail, Organisation, Billing (forfait), Start my MCP server

L’inscription crée votre compte, ses portefeuilles et votre propre serveur MCP. C’est le même parcours que pour la connexion.

- Où : pay.m.todaq.net → dashboard.qatom.ai/onboarding
- Qui : Propriétaire

Cómo:
1. Allez sur dashboard.qatom.ai et choisissez New? Register an account.
2. Saisissez votre e-mail, cliquez sur Continue et saisissez le code reçu par e-mail, ou utilisez Sign in with a passkey.
3. Étape 1, Organisation : Business name, Display name, Billing email, adresse et numéro fiscal facultatifs, puis Next.
4. Étape 2, Billing : choisissez un forfait (Builder, Pro, Max ou Enterprise), puis Start my MCP server.

Ce que vous verrez : Vous arrivez sur l’Overview du Dashboard avec le nom de votre compte, le badge du forfait et les encadrés 1 instance MCP et 0 article.

À noter :
- Configurez d’abord une passkey (S11) : chaque connexion et chaque page d’approbation ne demande alors qu’un toucher au lieu d’un code par e-mail.
- Le nouveau serveur met quelques minutes à devenir opérationnel ; la bannière peut indiquer Running avant que MCP → Overview n’affiche healthy.
- Si l’e-mail possède déjà un portefeuille Qatom, il se connecte à ce portefeuille.
- La liste des forfaits peut encore afficher un ancien nom pour Max ($300/mo).

Exemple : Le compte Qatom Demo a été inscrit ainsi avec le forfait Builder le 11 oct. 2026.

Link: https://www.qatom.ai/fr/capabilities#B34

### B5. Revenez à votre tableau de bord vendeur

Reconnectez-vous plus tard

Après l’inscription (B34), vous vous connectez de la même façon à chaque fois pour gérer les articles, votre serveur MCP et les paramètres.

- Où : dashboard.qatom.ai
- Qui : Vendeur

Cómo:
1. Ouvrez dashboard.qatom.ai et cliquez sur Sign in.
2. Saisissez votre e-mail et cliquez sur Continue, puis saisissez le code reçu par e-mail ; ou utilisez Sign in with a passkey.
3. Attendez que la page Overview se charge.

Ce que vous verrez : L’Overview affiche le nom de votre compte, le badge du forfait, l’état du MCP et des encadrés pour les instances MCP, les articles de catalogue et les revenus.

À noter :
- Configurez d’abord une passkey (S11) : chaque connexion et chaque page d’approbation ne demande alors qu’un toucher au lieu d’un code par e-mail.
- Utilisez l’e-mail avec lequel vous vous êtes inscrit ; un autre e-mail crée un nouveau portefeuille et un nouveau compte.

Link: https://www.qatom.ai/fr/capabilities#B5

### B7. Définissez le nom de vendeur que voient les acheteurs

Configurez les informations de l’entreprise et vérifiez l’e-mail de facturation (le nom de l’entreprise est le nom de vendeur que voient les acheteurs)

Le nom de votre entreprise est le nom de vendeur sur chaque article. Sans lui, la recherche affiche le vendeur comme "None" et les agents ne peuvent pas savoir à qui appartient l’article.

- Où : Dashboard → Account
- Qui : Propriétaire

Cómo:
1. Ouvrez Account (/dashboard/account).
2. Renseignez Account name et Business name ; ajoutez Business address et Tax number si vous le souhaitez.
3. Saisissez le Billing email et cliquez sur Send verification email, puis suivez l’e-mail.
4. Cliquez sur Save changes avant de publier le moindre article.
5. Depuis le chat (après A4) : demandez à votre agent de modifier le nom de l’entreprise ; il appelle account_update_details et vous approuvez la modification (B23).

Ce que vous verrez : catalog_search affiche le nom de votre entreprise comme vendeur au lieu de "None".

À noter :
- Configurez-le avant de publier ; les articles d’un vendeur sans nom d’entreprise affichent seller None.
- Delete this account, sur la même page, est irréversible.

Link: https://www.qatom.ai/fr/capabilities#B7

### B8. Choisissez l’offre adaptée à votre catalogue

Choisissez ou changez de forfait : Builder (gratuit), Pro ($20/mo), Max ($300/mo), Enterprise

Le forfait définit le nombre d’agents, d’articles et de transactions du compte. Builder est gratuit ; vous pouvez passer à un forfait supérieur à tout moment.

- Où : Première inscription ; Settings → Billing
- Qui : Propriétaire
- Argent : oui

Cómo:
1. À l’inscription, choisissez le forfait à l’étape 2 de l’onboarding.
2. Plus tard, ouvrez Settings → Billing et choisissez un forfait dans Plans.
3. Pour un forfait payant, utilisez Add a card.
4. Le changement s’applique immédiatement, au prorata.
5. Depuis le chat (après A4) : demandez à votre agent votre forfait et votre facturation ; il appelle account_info (forfait, statut, renouvellement, carte enregistrée, prochaine facture). Les changements de forfait et de carte se font dans le Dashboard ; l’agent vous donne la page avec account_dashboard_link.

Ce que vous verrez : Settings → Billing affiche le nouveau Current plan, et le badge de l’Overview correspond.

À noter :
- La fiche Builder indique 1 agent, jusqu’à 5 articles et 25 transactions par mois ; aucune carte n’est requise.
- Le forfait à $300/mo est Max ; certains écrans peuvent encore afficher un ancien nom.

Link: https://www.qatom.ai/fr/capabilities#B8

### B35. Obtenez de l’aide à la configuration sans quitter le Dashboard

Interrogez l’assistant du Dashboard ("What would you like to set up?")

L’accueil du Dashboard comporte un assistant IA. Il répond sur place aux questions de configuration, par exemple comment créer votre premier article.

- Où : Accueil du Dashboard
- Qui : Vendeur

Cómo:
1. Ouvrez l’accueil du Dashboard.
2. Repérez l’encadré intitulé "What would you like to set up?".
3. Choisissez un prompt de départ, comme "create my first catalog item" ou "how an agent pays", ou écrivez le vôtre.

Ce que vous verrez : L’assistant répond dans le panneau de la page d’accueil.

À noter :
- Pour l’instant, l’assistant vous guide ; c’est vous qui faites les modifications.

Link: https://www.qatom.ai/fr/capabilities#B35

### B9. Mettez une chose en vente à un prix donné

Créez un article de catalogue : nom, descripteur (ligne du reçu), prix, méthode, endpoint

Un article de catalogue est une chose en vente à un prix, avec un endpoint. Son nom devient le nom d’outil que voient les agents.

- Où : Catalog → New item, ou account_create_item
- Qui : Vendeur

Cómo:
1. Ouvrez Catalog et cliquez sur + New item (ou demandez à votre agent d’utiliser account_create_item).
2. Name : utilisez un préfixe commun, "Brand: item". Descriptor : la ligne sur le reçu de l’acheteur et sur son relevé de carte.
3. Price : 0 pour gratuit ("Enter 0 to offer it free"), sinon au moins 0.001 USD-TDN.
4. Method : GET, POST ou PUT. Endpoint : l’URL que Qatom appelle après le paiement, sans secrets.
5. Renseignez la description, le schéma et la visibilité (B10, B11, B14), ajoutez l’en-tête Authorization (B12) et cliquez sur Create item.

Ce que vous verrez : Vous revenez à la liste Catalog, où la nouvelle ligne affiche sa méthode et son prix (Free ou le montant).

À noter :
- Renommer l’article par la suite ne modifie pas le Descriptor.
- Choisissez la visibilité dès maintenant ; elle ne peut pas être modifiée après la création (B14).
- N’utilisez pas plus de trois décimales dans le prix.

Exemple : "Qatom Demo: space station video" est un article POST à 0.01 USD-TDN.

Link: https://www.qatom.ai/fr/capabilities#B9

### B10. Dites aux agents ce qu’ils reçoivent avant de payer

Rédigez la description (≤ 1 024 caractères, avec un lien vers llms.txt)

Les agents lisent la description pour décider d’acheter. Elle doit dire ce que l’article renvoie, ce qui est gratuit et où en savoir plus.

- Où : Formulaire de l’article
- Qui : Vendeur

Cómo:
1. Indiquez ce que renvoie l’article, ce qui est gratuit et quelles entrées modifient la réponse.
2. Ajoutez un lien vers l’URL de votre llms.txt.
3. Ajoutez une ligne précisant qu’il ne s’agit pas d’un conseil pour les articles de santé, de finance, d’investissement ou juridiques.
4. Limitez-la à 1 024 caractères ; le formulaire affiche un compteur (x / 1024).

Ce que vous verrez : Le compteur sous Description reste à 1024 ou moins.

À noter :
- N’énumérez pas les éléments individuels que vous couvrez (tickers, SKU, ID) et n’en donnez pas le nombre.
- Si le même contenu est vendu à deux prix, chaque description indique ce qu’apporte le niveau supérieur.
- Quand l’encadré est plein, le compteur peut masquer la dernière ligne ; relisez le texte avant d’enregistrer.

Link: https://www.qatom.ai/fr/capabilities#B10

### B11. Déclarez exactement les entrées que reçoit votre endpoint

Ajoutez le schéma d’entrée (additionalProperties: false) ; l’éditeur le valide

Le schéma indique aux agents quels arguments envoyer. Qatom ne transmet que les arguments déclarés et rejette les autres.

- Où : Formulaire de l’article
- Qui : Vendeur

Cómo:
1. Partez du schéma de votre endpoint : un string obligatoire qui identifie l’article, et une propriété facultative pour chaque entrée réelle.
2. Donnez à chaque propriété une description, avec son unité, sa plage et sa valeur par défaut.
3. Définissez "additionalProperties": false.
4. Collez-le dans l’éditeur Service schema sous la forme {"inputSchema": {...}} et cliquez sur Format.

Ce que vous verrez : L’éditeur affiche "Tool arguments: …", ou "Valid. The tool takes no arguments." lorsqu’il n’y en a aucun.

À noter :
- Laissez de côté tout ce que vous fixez dans l’URL de l’endpoint ou définissez comme paramètre de fulfilment.
- Aucun ID d’exemple ni nom d’article dans le schéma ; décrivez plutôt le format.
- L’éditeur de New item utilise {"inputSchema": {...}}, alors que les articles existants affichent un schéma simple.

Exemple : L’article vidéo de Qatom Demo accepte une entrée facultative, ttl_seconds, de 60 à 86400, 3600 par défaut.

Link: https://www.qatom.ai/fr/capabilities#B11

### B12. Protégez chaque article payant avec un en-tête secret

Ajoutez Request headers & secret parameters (en-tête Authorization, Sensitive) et enregistrez-les

Ce que vous configurez ici accompagne chaque appel de fulfilment vers votre endpoint et n’est jamais montré aux acheteurs. Votre endpoint peut ainsi vérifier que l’appel provient de Qatom.

- Où : Formulaire de l’article, avec son propre bouton Save
- Qui : Vendeur
- Secret : nécessite un secret

Cómo:
1. Dans Request headers & secret parameters, cliquez sur Add header.
2. Name : Authorization. Sensitivity : Sensitive. Value : Bearer suivi de votre jeton de fulfilment (saisissez-le vous-même).
3. Utilisez Add query parameter ou Add URL value pour une clé d’API d’un service externe ; utilisez Not sensitive pour des réglages fixes comme le niveau ou le format.
4. Dans le formulaire New item, Create item l’enregistre ; sur la page de l’article, cliquez sur Save headers & parameters.

Ce que vous verrez : L’en-tête apparaît dans la section, avec sa valeur masquée.

À noter :
- Les valeurs Sensitive ne sont plus jamais affichées ; conservez la valeur dans votre propre coffre de secrets.
- Les en-têtes sont propres à chaque article : trois articles payants sur un même endpoint ont chacun besoin de l’en-tête.
- Sur la page de l’article, Save changes seul peut laisser l’en-tête non enregistré ; vérifiez-le (B37).

Link: https://www.qatom.ai/fr/capabilities#B12

### B13. Placez entrées et secrets dans l’URL en toute sécurité

Utilisez {input.name} et {secret.name} dans l’endpoint

Les marqueurs permettent à l’URL de l’endpoint de transporter une entrée de l’acheteur ou un secret enregistré sans exposer le secret.

- Où : Formulaire de l’article
- Qui : Vendeur

Cómo:
1. Écrivez {input.name} à l’emplacement d’une entrée de l’acheteur, et déclarez cette entrée comme obligatoire dans le schéma.
2. Écrivez {secret.name} à l’emplacement d’un secret, et enregistrez-le comme URL value dans Request headers & secret parameters.
3. Exemple : https://api.example.com/points/{input.lat},{input.lon}/days?key={secret.apikey}.

Ce que vous verrez : Un achat test renvoie la réponse correspondant aux entrées envoyées.

À noter :
- N’écrivez jamais un vrai secret dans l’URL de l’endpoint ; d’autres utilisateurs du tableau de bord peuvent la voir.

Link: https://www.qatom.ai/fr/capabilities#B13

### B14. Choisissez public ou privé une seule fois, à la création

Choisissez public ou privé lors de la création de l’article

Les articles publics apparaissent dans la recherche du catalogue maître. Les articles privés ne sont accessibles que via votre propre instance MCP, et ce choix est définitif.

- Où : Formulaire de l’article
- Qui : Vendeur

Cómo:
1. Dans le formulaire New item, laissez "Private to this MCP instance" désactivé pour tout ce qui est vendu via le catalogue.
2. Cochez-le uniquement pour les articles qui restent dans votre propre instance, comme un outil interne ou un article destiné à un seul client.
3. Cliquez sur Create item.
4. Sur la page de l’article, vérifiez Visibility dans Commodity.

Ce que vous verrez : La page de l’article affiche Visibility comme Public ou Private, en lecture seule.

À noter :
- Dans le Dashboard, la visibilité ne peut plus être modifiée ensuite ; pour rendre un article public, dupliquez-le (B36).
- (à confirmer) account_update_item inclut désormais un champ private, qui pourrait permettre à un agent de modifier la visibilité avec votre approbation.
- Les articles privés n’apparaissent pas dans catalog_search et ne peuvent pas être achetés via le MCP maître.
- La liste du catalogue n’affiche pas de badge Private, et le texte Availability d’un article privé peut encore mentionner catalog_search.

Link: https://www.qatom.ai/fr/capabilities#B14

### B15. Donnez à un article son propre outil nommé

Mettez en avant des articles dans l’instance MCP du vendeur

Un article mis en avant est enregistré comme un outil à part entière dans votre instance MCP : les agents qui y sont connectés le voient sous son nom.

- Où : Formulaire de l’article
- Qui : Vendeur

Cómo:
1. Cochez Featured dans le formulaire New item, ou dans la section Agents de la page de l’article.
2. Enregistrez l’article.
3. Ouvrez MCP → Tools et cherchez l’article dans Featured items.

Ce que vous verrez : L’article apparaît comme un outil nommé, avec son schéma, dans MCP → Tools.

À noter :
- MCP → Tools peut lister des outils de la plateforme dans Featured items avec la mention "could not be found". Vérifiez-y vos propres articles.

Link: https://www.qatom.ai/fr/capabilities#B15

### B16. Offrez aux acheteurs un moyen gratuit de vous contacter

Ajoutez l’article gratuit de retours clients (un par défaut dans chaque catalogue), ainsi que des vérifications gratuites à côté des articles payants

Les acheteurs utilisent l’article de retours pour les questions, les problèmes et les demandes de remboursement. Les vérifications gratuites permettent aux agents de confirmer une entrée avant de payer.

- Où : Nouvel article au prix de 0
- Qui : Vendeur

Cómo:
1. Ouvrez Catalog et cherchez un article gratuit de retours clients ; s’il n’y en a pas, créez-en un avec + New item au prix de 0.
2. Nommez-le avec votre préfixe ("Brand: customer feedback") ; entrées : message (obligatoire, de 3 à 2 000 caractères), from_email et subject_ref facultatives.
3. Faites en sorte que l’endpoint enregistre chaque message et le transfère à l’adresse e-mail de votre compte, avec une limite horaire (30 est un bon point de départ).
4. À côté de chaque article payant, ajoutez un article gratuit de recherche, de vérification, d’aperçu ou de statut.

Ce que vous verrez : Un appel test à l’article de retours est gratuit et renvoie un id de référence.

À noter :
- N’acceptez jamais de retours que personne ne lira ; le modèle répond 503 not_configured tant que le stockage ou l’e-mail n’est pas configuré.
- Une réponse gratuite est une donnée fixe ou une vérification d’identité, jamais quelque chose qu’un script pourrait échantillonner pour obtenir la valeur payante.
- Pour l’instant, le vendeur crée l’article de retours ; bientôt, Qatom le créera automatiquement pour les nouveaux catalogues.

Exemple : "Qatom Demo: customer feedback" est gratuit et a renvoyé un id de référence lors des tests ; l’article de retours de Centaur League est la référence d’origine.

Link: https://www.qatom.ai/fr/capabilities#B16

### B37. Vérifiez que l’en-tête secret a bien été enregistré

Après avoir enregistré les en-têtes, rechargez l’article et vérifiez que l’en-tête apparaît (valeur masquée)

Un article payant sans son en-tête échoue à chaque appel de fulfilment, une fois l’acheteur ayant payé. Recharger est la seule vérification fiable.

- Où : Page de l’article → Request headers & secret parameters
- Qui : Vendeur

Cómo:
1. Après Save headers & parameters, rechargez la page de l’article.
2. Vérifiez que le formulaire affiche l’article que vous avez ouvert (nom et prix).
3. Vérifiez que Request headers & secret parameters liste Authorization avec la valeur masquée.
4. S’il indique "No headers or parameters", ajoutez de nouveau l’en-tête et cliquez sur Save headers & parameters.

Ce que vous verrez : La section liste l’en-tête avec sa valeur masquée.

À noter :
- Un avis "Catalog Item Updated" après Save changes ne signifie pas que l’en-tête a été enregistré.
- Les en-têtes saisis dans le formulaire New item sont enregistrés avec Create item ; le risque se situe sur la page de l’article.

Link: https://www.qatom.ai/fr/capabilities#B37

### B17. Recherchez, filtrez et mettez à jour n’importe quel article

Recherchez, filtrez et modifiez des articles

À mesure que le catalogue grandit, la recherche et les filtres le gardent gérable. Les modifications de prix et de schéma sont répercutées sur le MCP maître et sur votre instance.

- Où : Liste Catalog et page de l’article, account_catalog, account_update_item
- Qui : Vendeur

Cómo:
1. Dans Catalog, recherchez par nom, description ou endpoint.
2. Filtrez par Not archived, Active, Inactive, Archived ou All, et par méthode ; triez par Name, Price ou Created.
3. Ouvrez un article, modifiez les champs et cliquez sur Save changes ; pour créer une variante, utilisez Duplicate (B36).
4. Depuis le chat, demandez à votre agent de lister les articles (account_catalog) ou d’en modifier un (account_update_item).

Ce que vous verrez : Chaque filtre affiche son nombre d’articles, et l’enregistrement fait apparaître un avis "Catalog Item Updated".

À noter :
- Avant d’enregistrer, vérifiez que le formulaire affiche l’article sur lequel vous avez cliqué ; les pages d’articles peuvent charger lentement ou conserver les valeurs de l’article précédent.
- Dans une fenêtre étroite, le panneau de détail de l’article peut ne pas apparaître ; agrandissez la fenêtre.

Link: https://www.qatom.ai/fr/capabilities#B17

### B36. Copiez un article, puis retirez l’ancien

Dupliquez un article, puis archivez l’ancien

Duplicate permet de créer une variante, et c’est le seul moyen de rendre public un article privé. La copie est un nouvel article avec un nouvel id.

- Où : Page de l’article → Duplicate
- Qui : Vendeur
- Secret : nécessite un secret

Cómo:
1. Sur la page de l’article, cliquez sur Duplicate ; le formulaire New item s’ouvre, déjà rempli.
2. Modifiez ce qui diffère ; pour le rendre public, décochez Private to this MCP instance.
3. Saisissez de nouveau chaque valeur sensible ("Sensitive values were not copied; enter them again"), puis Create item.
4. Sur l’ancien article, Availability → Archive item, puis mettez à jour llms.txt et tout ce qui mentionne l’ancien id.

Ce que vous verrez : La copie apparaît dans la liste Catalog avec un nouvel id d’article, et l’ancien apparaît dans Archived.

À noter :
- Vérifiez l’interrupteur Private sur chaque copie ; une copie peut conserver le réglage de l’original.
- La copie reçoit aussi un nouveau twin fournisseur : les paiements arrivent donc à un nouvel endroit.
- Archive item n’a pas de boîte de dialogue de confirmation.

Link: https://www.qatom.ai/fr/capabilities#B36

### B18. Assurez-vous que votre propre serveur MCP fonctionne bien

Vérifiez l’instance MCP : URL du serveur, santé, outils, logs

Votre instance MCP sert vos articles mis en avant et privés. Vérifiez qu’elle est en bonne santé avant de tester ou de partager son URL.

- Où : MCP → Overview / Tools / Logs, account_mcp_server
- Qui : Vendeur

Cómo:
1. Ouvrez MCP → Overview : copiez le Server URL et vérifiez Status, Deploy version et Health (Overall, ECS tasks, Server DB, HTTP check).
2. Ouvrez Tools : vérifiez vos articles mis en avant et les outils intégrés, chacun avec son schéma d’entrée.
3. Ouvrez Logs pour voir l’activité récente.
4. Depuis le chat, demandez à votre agent les détails du serveur (account_mcp_server).

Ce que vous verrez : Health indique healthy et vos articles mis en avant apparaissent dans Tools.

À noter :
- Une nouvelle instance a besoin de quelques minutes pour être en bonne santé ; fiez-vous à Health, pas à la bannière d’Overview.
- Si les Logs semblent anciens, vérifiez plutôt Status et Health.

Link: https://www.qatom.ai/fr/capabilities#B18

### B39. Maintenez votre serveur MCP à la dernière version

Mettez à jour votre serveur MCP lorsque le Dashboard le propose

Lorsque Qatom publie une nouvelle version du serveur, la page MCP propose une mise à jour. La mise à jour maintient vos outils alignés sur le MCP maître.

- Où : MCP → Overview → Update available → Update instance
- Qui : Propriétaire

Cómo:
1. Ouvrez MCP → Overview.
2. S’il affiche Update available, cliquez sur Update instance.
3. Attendez que Health indique de nouveau healthy, puis vérifiez vos outils mis en avant dans Tools.

Ce que vous verrez : La version de déploiement augmente et Health repasse à healthy.

À noter :
- (à confirmer) Si les appels des acheteurs sont suspendus pendant la mise à jour.

Link: https://www.qatom.ai/fr/capabilities#B39

### B19. Achetez chaque article une fois avant de l’annoncer

Testez immédiatement : achetez chaque article une fois (les publics via le MCP maître, les privés via votre propre instance) avant de l’annoncer

Un achat réel est le seul test complet du prix, du schéma, de l’en-tête et de l’endpoint ensemble. Faites-le dès que l’article existe.

- Où : catalog_search + agent_checkout
- Qui : Vendeur
- Argent : oui

Cómo:
1. Connectez le MCP maître (https://mcp.m.todaq.net/mcp) ; pour les articles privés, connectez plutôt le Server URL de votre instance.
2. Alimentez le twin de l’agent avec un petit montant (fund_primary_wallet ou A32, puis transfer_to_agent).
3. Trouvez l’article avec catalog_search et achetez-le avec agent_checkout, seul et avec des entrées.
4. Approuvez l’achat lorsqu’on vous le demande, sauf si son prix est dans votre limite d’approbation automatique.
5. Testez aussi une entrée invalide et vérifiez que l’erreur est claire.

Ce que vous verrez : Le reçu affiche la réponse de votre endpoint et un id de transaction.

À noter :
- Un appel rejeté par votre endpoint peut quand même être facturé, et une nouvelle tentative est une nouvelle facturation.
- Tester les articles gratuits ne coûte rien.
- Les articles privés sont introuvables via le MCP maître ; c’est normal.

Exemple : Les trois articles de Qatom Demo ont été achetés via le MCP maître. L’article de retours a renvoyé un id de référence, le SHA-256 de la skill correspondait et la vidéo a été lue en 1080p.

Link: https://www.qatom.ai/fr/capabilities#B19

### B38. Passez les vérifications de lancement et mettez en ligne

Lancez les vérifications de lancement avant d’annoncer

Le rapport de lancement du guide vendeur vérifie chaque article tel que l’agent d’un acheteur le trouve. N’annoncez qu’une fois qu’il passe.

- Où : Skill guide vendeur (rapport de lancement), MCP maître
- Qui : Vendeur

Cómo:
1. Avec la skill guide vendeur installée, demandez à votre agent d’exécuter le rapport de lancement de vos articles.
2. Corrigez chaque échec qu’il liste, comme un article de retours manquant, une URL d’endpoint contenant un secret ou une description sans le lien vers votre llms.txt.
3. Exécutez-le de nouveau jusqu’à ce que tous les articles passent.

Ce que vous verrez : Un rapport de lancement qui liste chaque article avec ses vérifications réussies.

À noter :
- Les achats tests (B19) passent en premier ; le rapport utilise leurs résultats.

Link: https://www.qatom.ai/fr/capabilities#B38

### B40. Préparez-vous aux achats par panier

Préparez-vous à ce que les acheteurs achètent vos articles dans des paniers

Les acheteurs peuvent mettre vos articles dans un panier avec d’autres articles, les vôtres ou ceux d’autres vendeurs, et payer une seule fois. Chaque article du panier arrive à votre endpoint comme un appel payé distinct, avec ses propres entrées et son propre id de transaction.

- Où : Votre endpoint et le chat de l’acheteur
- Qui : Vendeur

Cómo:
1. Assurez-vous que chaque article fonctionne en un seul appel ; un panier envoie un appel par exemplaire, après le paiement.
2. Renvoyez un résumé clair et des liens dans chaque réponse : l’agent de l’acheteur les affiche une seule fois, dans la réponse du panier.
3. Décrivez entièrement les entrées dans le schéma de l’article, pour que les agents puissent les réunir avant d’ajouter l’article à un panier.
4. Testez en mettant deux de vos articles dans un panier et en payant depuis un portefeuille d’agent (A33, A34).

Ce que vous verrez : Vos ventes affichent une transaction par exemplaire d’article, comme pour les achats individuels.

À noter :
- Les liens de votre réponse doivent rester valides au-delà du moment où le panier est payé ; un lien de 15 minutes peut expirer avant que l’acheteur ne lise une longue réponse.
- Un acheteur peut interrompre un panier en cours de route ; les articles déjà livrés restent achetés.

Exemple : Les articles retours, skill et vidéo de Qatom Demo ont été achetés ensemble dans un panier le 12 octobre ; chacun a renvoyé sa propre réponse.

Link: https://www.qatom.ai/fr/capabilities#B40

### B20. Livrez chaque vente payée une fois, et une seule

Vérifiez qu’un appel de livraison correspond à une vente réelle (X-Qatom-Transaction-Id)

Pour tout ce qui est coûteux à livrer, vérifiez que chaque appel correspond à une vente réglée de votre article. Vous évitez ainsi les appels répétés ou falsifiés.

- Où : Endpoint du vendeur + API
- Qui : Vendeur

Cómo:
1. Lisez l’en-tête X-Qatom-Transaction-Id à chaque appel de livraison.
2. Appelez GET /v4/catalog/purchases/{transaction_id} avec les identifiants de votre compte (B30).
3. Rejetez l’appel si l’id est inconnu ou appartient à un autre article.
4. Conservez les ids déjà livrés, pour qu’aucune vente ne soit livrée deux fois.

Ce que vous verrez : L’API renvoie la vente réglée de votre article et votre endpoint la livre.

À noter :
- Utilisez ceci pour les clés de streaming, les téléchargements et les inscriptions à des parties ; les lectures peu coûteuses peuvent se fier à l’en-tête de livraison.

Link: https://www.qatom.ai/fr/capabilities#B20

### B21. Vérifiez qu’on vous trouve, puis prévenez les gens

Confirmez que les articles publics apparaissent dans catalog_search, puis annoncez-les (partagez llms.txt, STORES.md)

Les acheteurs trouvent les articles avec catalog_search sur le MCP maître. N’annoncez que lorsque vos articles y apparaissent et passent vos vérifications de lancement.

- Où : Formulaire de l’article, catalog_search
- Qui : Vendeur

Cómo:
1. Sur le MCP maître, exécutez catalog_search avec le préfixe de votre marque.
2. Vérifiez le nom, le prix, le nom du vendeur et la description de chaque article public.
3. Exécutez le rapport de lancement du guide du vendeur et corrigez toute anomalie.
4. Annoncez : partagez l’URL de votre llms.txt et ajoutez votre boutique à STORES.md (B26).

Ce que vous verrez : catalog_search affiche chaque article public avec le nom de votre entreprise comme vendeur.

À noter :
- Les articles privés n’apparaissent jamais dans catalog_search ; c’est voulu.
- Retirez de la liste ou archivez les articles de test et de remplissage avant d’annoncer.
- (à confirmer) Le délai avant qu’un nouvel article public apparaisse dans catalog_search. S’il n’apparaît pas, attendez quelques minutes et relancez la recherche avant de conclure à un échec.

Link: https://www.qatom.ai/fr/capabilities#B21

### B22. Voyez combien chaque article a rapporté

Consultez les ventes et les revenus

Les chiffres de ventes montrent quels articles se vendent. Les revenus de chaque article arrivent sur son twin ; la Console indique qui a payé.

- Où : Cartes Overview, Sales sur la page de l’article / GET /v4/catalog/revenue (vue des revenus bientôt disponible)
- Qui : Vendeur

Cómo:
1. Dans Overview, lisez la carte Revenue (USD-TDN et transactions).
2. Sur la page d’un article, lisez Sales : Sales count et Earned.
3. Via l’API, GET /v4/catalog/revenue additionne ce que vos articles ont rapporté.
4. Pour voir qui a payé, ouvrez le twin de l’article dans la Qatom Console.
5. Depuis le chat (après A4) : demandez à votre agent combien votre catalogue a rapporté ; il appelle account_sales (total historique et nombre de ventes, ou les dernières ventes d’un article avec item_id).

Ce que vous verrez : La page de l’article affiche son Sales count et son Earned en USD-TDN.

À noter :
- La carte Revenue renvoie vers la liste Catalog ; une vue dédiée aux revenus manque encore.
- Le nombre de transactions ne doit inclure que les transactions payées.

Link: https://www.qatom.ai/fr/capabilities#B22

### B23. Laissez votre agent modifier la configuration, avec votre accord

Effectuez une modification du compte via un agent, avec approbation

Votre agent peut préparer des modifications du compte depuis le chat : créer ou modifier un article, changer les informations de l’entreprise, renommer un portefeuille, redémarrer votre serveur MCP. Rien ne change tant que vous n’avez pas approuvé cette modification précise.

- Où : account_finish_change
- Qui : Propriétaire

Cómo:
1. Choisissez d’abord votre compte vendeur pour le chat (A4).
2. Demandez la modification à votre agent ; il appelle l’outil correspondant (account_create_item, account_update_item, account_update_details, account_rename_wallet ou account_reboot_server) et vous donne un lien d’approbation.
3. Connectez-vous (avec une passkey, c’est une simple touche). La page affiche le Change et l’Account ; vérifiez les deux, puis approuvez.
4. Lorsque la page affiche "Approved. Go back to your conversation to let the agent finish", prévenez l’agent. Il appelle account_finish_change, qui applique la modification une seule fois et refuse une seconde tentative.

Ce que vous verrez : L’agent indique que la modification est faite et le compte l’affiche (par exemple, le nouveau nom du portefeuille dans account_wallets ou dans le Dashboard du vendeur).

À noter :
- Les secrets ne passent jamais par le chat : pour les en-têtes d’un article, l’agent vous donne un lien vers le Dashboard (A26).
- Les outils account_ (account_choose, account_wallets, account_dashboard_link et les autres) apparaissent dans certaines connexions et pas dans d’autres, et ne fonctionnent qu’une fois un compte professionnel choisi. (à confirmer) Quelles connexions les affichent.

Exemple : Le 12 octobre, le compte vendeur de Dobox a renommé depuis le chat un portefeuille en double inutilisé : une page d’approbation, puis account_finish_change ; un second appel de finalisation a été refusé.

Link: https://www.qatom.ai/fr/capabilities#B23

### B24. Changez un secret sans interrompre les ventes

Faites la rotation d’un secret de livraison sans appels en échec

Faites la rotation du jeton de livraison dès qu’il a pu fuiter. Une courte période de chevauchement permet à tous les appels de continuer à fonctionner.

- Où : Hôte + formulaire de l’article
- Qui : Vendeur
- Secret : nécessite un secret

Cómo:
1. Générez une nouvelle valeur sur votre propre machine (openssl rand -hex 24).
2. Faites accepter à l’endpoint l’ancienne et la nouvelle valeur pendant quelques minutes.
3. Définissez la nouvelle valeur dans le coffre de secrets de votre hôte et dans l’en-tête Authorization de chaque article ; cliquez ensuite sur Save headers & parameters.
4. Rechargez chaque article pour vérifier l’en-tête (B37), puis retirez l’ancienne valeur de l’endpoint.

Ce que vous verrez : Un achat test fonctionne, et un appel direct avec l’ancienne valeur reçoit une 404.

À noter :
- Les en-têtes sont définis par article ; mettez à jour chaque article payant qui utilise le jeton.

Link: https://www.qatom.ai/fr/capabilities#B24

### B25. Mettez en pause ou retirez un article

Désactivez ou archivez un article

Deactivate suspend les ventes et peut être annulé. Archive retire de la vente un article abandonné ou mal publié ; il n’apparaît ensuite qu’avec le filtre Archived.

- Où : Article → Availability
- Qui : Vendeur

Cómo:
1. Ouvrez la page de l’article et allez dans Availability.
2. Cliquez sur Deactivate item pour le retirer de la recherche et refuser les nouveaux achats ; vous pouvez le réactiver.
3. Ou cliquez sur Archive item pour le retirer de la vente ; il n’apparaît ensuite qu’avec le filtre Archived.

Ce que vous verrez : L’article apparaît avec le filtre Inactive ou Archived dans la liste Catalog.

À noter :
- Archive item n’a pas de boîte de dialogue de confirmation ; utilisez Deactivate si vous risquez de vouloir le récupérer.

Link: https://www.qatom.ai/fr/capabilities#B25

### B26. Faites voir et évaluer votre boutique

Figurez dans STORES.md et obtenez une note du service Rating & Review

STORES.md liste les boutiques Qatom actives. Le service Rating & Review note les publications selon le guide du vendeur.

- Où : PR sur GitHub, service d’évaluation
- Qui : Vendeur

Cómo:
1. Ouvrez une pull request qui ajoute votre boutique à STORES.md dans le dépôt qatom-hack-the-andes.
2. Suivez chaque étape du guide du vendeur, y compris les vérifications de lancement, pour que la publication obtienne une bonne note.

Ce que vous verrez : Votre boutique apparaît dans STORES.md une fois la pull request fusionnée.

À noter :
- (à confirmer) Les notations sont en cours de déploiement ; la manière de soumettre une boutique à la notation reste à confirmer.

Link: https://www.qatom.ai/fr/capabilities#B26

### B27. Répondez aux demandes de remboursement depuis votre portefeuille principal

Traitez les litiges de paiement et les remboursements : lisez les commentaires, vérifiez la transaction, remboursez depuis le twin principal

Les acheteurs demandent des remboursements via votre article de commentaires. Les paiements sont réglés instantanément ; les remboursements relèvent de votre décision et reviennent au portefeuille qui a payé.

- Où : Boîte de réception des commentaires, Send dans la Console
- Qui : Vendeur
- Argent : oui

Cómo:
1. Lisez le message de commentaire et notez l’id de transaction.
2. Vérifiez la vente : GET /v4/catalog/purchases/{transaction_id}, ou le twin de l’article dans la Qatom Console.
3. Si vous remboursez, utilisez Send sur votre twin principal (rôle Transfer) vers le portefeuille qui a payé, ou POST /v4/transfer.
4. Répondez à l’acheteur en indiquant ce que vous avez fait.

Ce que vous verrez : Une ligne Sent apparaît dans les Transactions du twin principal.

À noter :
- Les fonds doivent se trouver sur le twin principal ; les revenus des articles y arrivent via une distribution permanente.
- Ne relancez jamais un transfert qui a renvoyé 202 ; il a déjà été effectué.
- Ne promettez pas de délais à l’acheteur.

Link: https://www.qatom.ai/fr/capabilities#B27

### B28. Montrez aux acheteurs un tableau de bord, une carte ou un lecteur dans le chat

Créez une vue interactive MCP App pour les acheteurs (facultatif)

Une vue MCP App place un tableau de bord, une carte ou un lecteur en direct dans la conversation. Hébergez-la sur un serveur gratuit ; l’argent reste dans Qatom.

- Où : Serveur MCP gratuit du vendeur
- Qui : Vendeur

Cómo:
1. Partez de examples/mcp-app-minimal dans le dépôt qatom-use-cases.
2. Associez une vue à un outil et renvoyez à la fois du texte pour le modèle et du structuredContent pour la vue.
3. Hébergez-la sur votre propre serveur MCP gratuit, séparé de vos articles payants.
4. Demandez aux acheteurs de l’ajouter comme second connecteur à côté du MCP maître.

Ce que vous verrez : Dans un client compatible avec les MCP Apps, le résultat de l’outil s’ouvre sous forme de vue interactive dans le chat.

À noter :
- Les MCP Apps (tableaux de bord, cartes, lecteurs dans le chat) fonctionnent aujourd’hui dans Claude, ChatGPT et Hermes. Grok et Muse ne les prennent pas encore en charge.
- Aucun achat ne commence dans une vue ; la personne approuve le paiement dans le flux propre à Qatom.
- Changez le suffixe de l’URI de la vue (-v1, -v2) à chaque modification ; les hôtes mettent les vues en cache.

Exemple : view_match de Centaur League ouvre un échiquier dans le chat depuis son serveur gratuit sur centaurleague.games/mcp.

Link: https://www.qatom.ai/fr/capabilities#B28

### B29. Émettez et révoquez des clés pour votre compte

Créez et révoquez des API keys du compte

Les API keys du compte permettent à vos propres systèmes d’appeler Qatom pour ce compte. Révoquez toute clé que vous n’utilisez plus.

- Où : Settings → API Keys
- Qui : Propriétaire
- Secret : nécessite un secret

Cómo:
1. Ouvrez Settings → API Keys.
2. Dans Create a key, saisissez un nom et créez-la.
3. Conservez la clé dans votre coffre de secrets, jamais dans un dépôt ni dans un chat.
4. Pour qu’une clé cesse de fonctionner, cliquez sur Revoke à côté d’elle.

Ce que vous verrez : La clé apparaît avec ses dates de création et de dernière utilisation.

À noter :
- Vérifiez la dernière utilisation avant de révoquer une clé dont un système pourrait encore avoir besoin.

Link: https://www.qatom.ai/fr/capabilities#B29

### B30. Obtenez les identifiants qu’utilise votre serveur

Obtenez les identifiants de votre serveur et le secret public

Votre serveur échange les identifiants client contre un jeton de compte pour des appels comme les paiements et la vérification des ventes. Le secret public sert aux embeds et au guest checkout.

- Où : Settings → Secrets
- Qui : Propriétaire
- Secret : nécessite un secret

Cómo:
1. Ouvrez Settings → Secrets.
2. Copiez le Client ID ; cliquez sur Reveal pour voir le Client secret.
3. Conservez-les uniquement sur votre serveur, puis échangez-les contre un jeton de compte sur /v4/account/oauth/token.
4. Copiez le Public secret pour les embeds et le guest checkout.

Ce que vous verrez : L’onglet Secrets affiche le Client ID, un Client secret masqué avec Reveal et le Public secret.

À noter :
- Ne placez jamais le client secret dans un navigateur, une app ou un dépôt.
- Le secret public peut être publié ; le client secret, non.

Link: https://www.qatom.ai/fr/capabilities#B30

### B31. Sachez quel portefeuille contient quoi

Consultez vos twins, renommez-les et trouvez l’API key d’un twin

Votre compte comporte plusieurs twins : le principal, celui de l’agent et un twin fournisseur par article. Les paiements arrivent sur le twin fournisseur de l’article.

- Où : Twins → twin
- Qui : Propriétaire
- Secret : nécessite un secret

Cómo:
1. Ouvrez Twins ; recherchez par nom ou hostname et filtrez par All, Primary, Agent ou Provider.
2. Ouvrez un twin pour voir son Twin ID, son Hostname, son Type et ses soldes.
3. Modifiez son Name affiché et cliquez sur Save name.
4. Copiez son API key uniquement lorsque vous en avez besoin, par exemple pour les payeurs de Payment Multiplex.

Ce que vous verrez : La page du twin affiche son identité, son nom et ses soldes par quantité numérique.

À noter :
- L’API key donne un accès direct au twin ; traitez-la comme un secret.
- Les twins fournisseurs n’apparaissent qu’une fois des articles créés.

Link: https://www.qatom.ai/fr/capabilities#B31

### B32. Placez votre serveur MCP sur votre domaine

Servez l’instance MCP depuis votre propre domaine

Un domaine personnalisé permet aux acheteurs de se connecter à votre instance à une adresse qui vous appartient. L’URL par défaut continue de fonctionner.

- Où : MCP → Custom domain
- Qui : Propriétaire

Cómo:
1. Ouvrez MCP → Overview → Custom domain et cliquez sur Add domain.
2. Pour un sous-domaine, ajoutez un enregistrement CNAME chez votre fournisseur DNS.
3. Pour un domaine racine, utilisez le CNAME flattening ou un enregistrement ALIAS.

Ce que vous verrez : (à confirmer) Votre domaine apparaît dans Custom domain.

À noter :
- L’URL par défaut du serveur continue de fonctionner, les connexions existantes ne sont donc pas interrompues.

Link: https://www.qatom.ai/fr/capabilities#B32

### B33. Redémarrez votre serveur ou supprimez-le définitivement

Redémarrez l’instance MCP après des modifications ; détruisez-la (irréversible)

Reboot redémarre votre instance. Destroy la supprime définitivement et change son hostname et sa clé.

- Où : MCP → Lifecycle / Danger zone, account_reboot_server
- Qui : Propriétaire

Cómo:
1. Pour redémarrer, ouvrez MCP → Overview → Lifecycle et cliquez sur Reboot instance, ou demandez-le à votre agent (account_reboot_server).
2. Vérifiez ensuite Status et Health.
3. Uniquement pour supprimer définitivement l’instance : Danger zone → Destroy instance.

Ce que vous verrez : Après un redémarrage, MCP → Overview montre l’instance de nouveau en fonctionnement.

À noter :
- Le redémarrage interrompt brièvement les requêtes en cours.
- Destroy est irréversible : l’instance reçoit un nouveau hostname et une nouvelle API key, mettez donc à jour toutes les connexions qui y mènent.

Link: https://www.qatom.ai/fr/capabilities#B33

## Console (dans la Qatom Console)

Tout ce qui se passe après la vente a lieu dans la Qatom Console, sur console.todaq.net, twin par twin : paiements, distributions et retraits.

### C1. Connectez-vous à la Qatom Console

Connectez-vous à la Qatom Console (lien par e-mail ou passkey) et autorisez-la

La Qatom Console est l’endroit où les propriétaires consultent, vérifient et déplacent ce que détiennent leurs twins. La première connexion vous demande aussi d’autoriser la Console.

- Où : console.todaq.net → Sign in to TODAQ Enterprise
- Qui : Membre du groupe

Cómo:
1. Allez sur console.todaq.net et cliquez sur Sign in to TODAQ Enterprise.
2. Utilisez votre passkey (clé d’accès), ou saisissez votre e-mail et cliquez sur Send sign-in link.
3. Ouvrez le lien reçu par e-mail dans les 15 minutes.
4. La première fois uniquement : vérifiez ce que demande Qatom Console (identité, e-mail, appartenance aux groupes) et autorisez-la.

Ce que vous verrez : Home s’ouvre avec My Twins, qui affiche chaque twin auquel vous avez accès avec son badge de rôle et son solde.

À noter :
- Le lien de connexion expire après 15 minutes ; s’il a expiré, demandez-en un nouveau.
- Les connexions suivantes sautent l’écran d’autorisation.

Link: https://www.qatom.ai/fr/capabilities#C1

### C2. Connectez-vous plus vite avec une passkey

Configurez une passkey

Une passkey (clé d’accès) vous permet de vous connecter sans attendre un lien par e-mail. Elle reste sur votre propre appareil.

- Où : Account → Passkeys (menu de gauche, au-dessus de la vue du twin)
- Qui : Membre du groupe
- Secret : nécessite un secret

Cómo:
1. Connectez-vous avec un lien par e-mail (C1).
2. Dans le menu de gauche, ouvrez Account → Passkeys.
3. Dans Register New Passkey, donnez-lui un nom facultatif (par exemple, votre ordinateur portable) et cliquez sur Register Passkey.
4. Suivez les instructions de votre appareil.

Ce que vous verrez : Your Passkeys affiche la nouvelle passkey avec sa date de création, ainsi que Rename et Delete.

À noter :
- Seule la personne titulaire de la connexion crée ou utilise une passkey ; un agent ne le fait jamais.

Link: https://www.qatom.ai/fr/capabilities#C2

### C3. Trouvez chaque twin auquel vous avez accès

Trouvez vos twins : recherche, épinglage, badges de rôle, soldes

Home affiche les twins auxquels vous avez accès, avec votre rôle sur chacun. Commencez ici pour trouver le portefeuille dont vous avez besoin.

- Où : Home → Mine
- Qui : Membre du groupe

Cómo:
1. Ouvrez Home ; Mine affiche vos twins.
2. Recherchez par nom du twin, URL ou e-mail.
3. Cliquez sur l’étoile d’un twin pour l’épingler.
4. Lisez le badge de rôle de chaque twin (Admin, Transfer ou Read-only) et son solde.

Ce que vous verrez : Chaque ligne affiche le nom du twin, l’hôte, le badge de rôle et le solde.

À noter :
- Juste après un changement de votre rôle, certains twins peuvent apparaître sans nom ou sans solde ; déconnectez-vous puis reconnectez-vous (C32).

Link: https://www.qatom.ai/fr/capabilities#C3

### C4. Voyez le solde de tout un groupe d’un coup

Ouvrez un groupe de twins et consultez son total en USD-TDN

Un groupe de twins réunit les twins d’un client ou d’un projet. Sa page additionne le solde de tous ces twins.

- Où : Home → Groups → page du groupe
- Qui : Administrateur du groupe

Cómo:
1. Dans Home, ouvrez Groups (visible par les administrateurs du groupe).
2. Cliquez sur un groupe pour ouvrir sa page.
3. Lisez Total TDN et recherchez parmi les twins du groupe.

Ce que vous verrez : La page du groupe affiche Total TDN et la liste des twins du groupe.

À noter :
- Vous devez avoir le rôle Manager dans le groupe pour voir Groups.

Exemple : Le groupe de Centaur League réunit ses twins principaux, son twin d’agent et les twins de ses articles du catalogue.

Link: https://www.qatom.ai/fr/capabilities#C4

### C5. Voyez le solde et l’activité la plus récente d’un twin

Lisez la carte portefeuille d’un twin et son activité récente

La page d’un twin est son portefeuille : le solde en USD-TDN (affiché en TDN) et qui il a payé ou qui l’a payé récemment.

- Où : Page du twin
- Qui : Tout rôle

Cómo:
1. Depuis Home, cliquez sur un twin.
2. Lisez la carte portefeuille : jeton, solde et valeur approximative en USD.
3. Utilisez les boutons de la carte selon vos besoins : Send, Buy, Bank Transfer, History.
4. Descendez jusqu’à Recent Activity pour voir les contreparties par nom ou e-mail.

Ce que vous verrez : La carte portefeuille affiche le solde en TDN avec sa valeur en USD, au-dessus de Recent Activity.

À noter :
- Send requiert le rôle Transfer ; le rôle Admin seul ne l’active pas.
- Les twins d’articles du catalogue dotés d’une distribution permanente n’ont pas de Send ; les envois sont gérés par la distribution.

Link: https://www.qatom.ai/fr/capabilities#C5

### C6. Voyez exactement ce que contient un twin

Consultez les fichiers TODA : binder, racine d’identité, notes USD-TDN

Chaque note USD-TDN et chaque enregistrement détenus par un twin sont un fichier TODA. Inventory les affiche, pour que vous voyiez ce que possède le twin.

- Où : Wallet → Inventory
- Qui : Tout rôle

Cómo:
1. Ouvrez le twin, puis Wallet → Inventory.
2. Dans TODA Files, ouvrez le binder (le registre du twin recensant tous ses fichiers) ou la racine d’identité (SDA).
3. Sur la carte TDN, lisez le solde et les notes qui le composent.
4. Cliquez sur View transactions pour accéder à l’historique.

Ce que vous verrez : Le binder indique "Valid twin binder of record" et la carte TDN affiche chaque note avec sa valeur.

À noter :
- Les USD-TDN sont conservés sous forme de notes de valeurs fixes, comme des espèces ; un paiement envoie des notes entières et garde la monnaie.

Link: https://www.qatom.ai/fr/capabilities#C6

### C7. Retracez l’historique complet d’une note

Inspectez une note : informations d’émission et historique de provenance

Chaque note porte sa propre piste d’audit. Utilisez-la pour prouver d’où vient l’argent et comment il a circulé.

- Où : Inventory → note
- Qui : Tout rôle

Cómo:
1. Dans Wallet → Inventory, cliquez sur une note de la carte TDN.
2. Lisez Note Value et Minting Info : émetteur TODAQ Micro Inc., actif TDN, dollars américains prépayés et conditions de TDN.
3. Lisez Provenance History : chaque révision, transfert et division, avec son hash et le twin qui la contrôle.

Ce que vous verrez : Provenance History montre chaque étape de la vie de la note, chacune avec un hash et le twin qui la détenait.

À noter :
- Pour prouver un paiement à une autre personne, combinez Provenance History avec le fichier .toda téléchargé (C8).

Link: https://www.qatom.ai/fr/capabilities#C7

### C8. Vérifiez le verdict d’un fichier et gardez-en une copie

Vérifiez l’intégrité d’un fichier ; téléchargez le fichier .toda

Les fichiers TODA sont vérifiables de manière autonome. La Console affiche un verdict et vous permet de télécharger le fichier.

- Où : Inventory → fichier
- Qui : Tout rôle

Cómo:
1. Ouvrez le binder ou la racine d’identité (SDA) depuis Wallet → Inventory.
2. Lisez le verdict de vérification en haut de la page.
3. Cliquez sur Download .toda File pour enregistrer une copie ; les notes ont le même bouton.

Ce que vous verrez : La racine d’identité affiche "Integrity certified by TODAQ Instant Relay" ; le binder affiche "Valid twin binder of record".

À noter :
- Pour l’instant, les pages de notes affichent un encadré Verification Status vide ; le binder et la racine d’identité affichent bien un verdict.

Link: https://www.qatom.ai/fr/capabilities#C8

### C9. Consultez et exportez le registre d’un twin

Lisez les transactions ; filtrez et exportez en CSV

Transactions est le registre comptable du twin, avec solde cumulé. Exportez-le pour votre comptabilité ou pour répondre à un acheteur.

- Où : Wallet → Transactions
- Qui : Tout rôle

Cómo:
1. Ouvrez le twin, puis Wallet → Transactions.
2. Filtrez par date et par token ; incluez les actifs non quantitatifs si nécessaire.
3. Lisez Type (Sent, Received, Microdistribution Income), To/From, Withdrawal, Deposit et Balance.
4. Cliquez sur Export CSV pour enregistrer la liste.

Ce que vous verrez : Une liste datée avec une colonne Balance cumulée ; Export CSV l’enregistre sous forme de fichier.

À noter :
- Les lignes Microdistribution Income sont des revenus provenant des twins de vos articles de catalogue.
- Un retrait apparaît comme Sent vers un twin sans nom, la passerelle bancaire ; retrouvez-le par heure et montant dans Transfer History (C27).

Link: https://www.qatom.ai/fr/capabilities#C9

### C10. Ouvrez une transaction pour en voir tout le détail

Ouvrez une transaction : détails internes du transfert, notes, id de distribution

La page d’une transaction contient son id et la manière dont elle a été effectuée. Utilisez-la quand un acheteur ou un vendeur pose une question sur un paiement.

- Où : Transactions → ligne
- Qui : Tout rôle

Cómo:
1. Dans Wallet → Transactions, cliquez sur Details sur une ligne.
2. Lisez le statut, la contrepartie, le montant, le type d’écriture (Quantitative Transfer) et le Transaction ID.
3. Pour un envoi, ouvrez Transfer Internals : id de transfert, durée, id de requête et le tableau note par note.
4. Pour un balayage de revenus, lisez l’id de la règle de distribution et les notes associées.

Ce que vous verrez : La page de détail affiche le Transaction ID et, pour les envois, Transfer Internals.

À noter :
- "Balance after" dans Transfer Internals peut être erroné lorsque des balayages arrivent juste après un envoi ; fiez-vous au Balance cumulé de la liste.

Link: https://www.qatom.ai/fr/capabilities#C10

### C11. Trouvez un paiement qui semble bloqué

Suivez les transferts sortants ; repérez ceux qui sont bloqués

Transfer Activity montre chaque transfert envoyé par le twin, avec son statut. C’est le premier endroit où chercher lorsqu’un paiement n’est pas arrivé.

- Où : Wallet → Transfer Activity
- Qui : Tout rôle

Cómo:
1. Ouvrez le twin, puis Wallet → Transfer Activity.
2. Filtrez par All, In progress ou Needs attention.
3. Lisez Started, Recipient et le mémo, Amount, Status et Transfer ID.

Ce que vous verrez : Chaque transfert sortant affiche un statut : In progress, Completed, Needs attention ou Not sent.

À noter :
- Consultez d’abord Needs attention lorsqu’un paiement semble bloqué.

Link: https://www.qatom.ai/fr/capabilities#C11

### C12. Voyez quelles notes ont bougé lors d’un transfert

Voyez comment un transfert a été constitué (division, monnaie, livraison)

Les USD-TDN circulent sous forme de notes entières, comme des espèces. La page de détail montre quelles notes sont parties, quelle monnaie a été conservée et quand chacune est arrivée.

- Où : Transfer Activity → ligne
- Qui : Tout rôle

Cómo:
1. Dans Transfer Activity, cliquez sur un transfert.
2. Lisez To, Amount, Started, Completed, Memo et la transaction liée.
3. Lisez le tableau Notes : chaque note apparaît comme Split off, Change kept ou Sent whole, avec son heure de livraison.

Ce que vous verrez : Le tableau Notes montre exactement quelles notes ont circulé et quelle monnaie a été conservée.

À noter :
- Les notes d’un même paiement peuvent arriver à des moments différents, parfois à quelques minutes d’intervalle.

Link: https://www.qatom.ai/fr/capabilities#C12

### C13. Voyez qui a payé chaque vente

Trouvez qui a payé un article

Chaque article de catalogue a son propre twin fournisseur, sur lequel arrivent ses paiements. Son Recent Activity affiche le nom de chaque payeur.

- Où : Twin fournisseur de l’article → Recent Activity
- Qui : Tout rôle

Cómo:
1. Trouvez le twin fournisseur de l’article : cherchez le nom de l’article dans Home, ou allez dans Dashboard → Twins → Provider.
2. Ouvrez le twin et lisez Recent Activity.
3. Chaque paiement affiche l’e-mail ou le twin du payeur, le montant et l’heure.
4. Dans le code : GET /v4/commodity/{hash}/transactions avec le hash de commodity de l’article (affiché comme Commodity ID ; à confirmer).

Ce que vous verrez : Recent Activity liste chaque paiement avec l’e-mail ou le twin du payeur.

Exemple : Dans Centaur League, le twin d’un article payant liste le paiement d’inscription de chaque équipe par l’e-mail du payeur.

Link: https://www.qatom.ai/fr/capabilities#C13

### C14. Payez une personne ou un twin, ou effectuez un remboursement

Envoyez des USD-TDN à un autre twin

Send transfère des USD-TDN d’un twin que vous contrôlez vers un autre twin. Utilisez-le depuis le twin principal pour un paiement ponctuel ou un remboursement.

- Où : Page du twin → Send (Transfer Notes)
- Qui : Rôle Transfer
- Argent : oui

Cómo:
1. Ouvrez le twin depuis lequel vous payez (en général le principal) et cliquez sur Send.
2. Choisissez la Currency ; son solde s’affiche à côté.
3. Saisissez l’Amount, la Recipient Twin URL et un Memo facultatif pour le destinataire.
4. Vérifiez l’origine, la destination et le montant, puis cliquez sur Transfer.

Ce que vous verrez : Le transfert apparaît dans Wallet → Transfer Activity, puis comme Sent dans Transactions.

À noter :
- Send nécessite le rôle Transfer ; après un changement de rôle, déconnectez-vous puis reconnectez-vous.
- Par API, un 202 signifie que l’argent a déjà été transféré ; ne relancez jamais la requête.
- Aujourd’hui, Send utilise une URL de twin ; le paiement par e-mail est prévu, comme c’est déjà le cas pour les distributions.

Link: https://www.qatom.ai/fr/capabilities#C14

### C15. Achetez des USD-TDN à Treasury par virement (wire) ou ACH

Demandez à acheter des USD-TDN à Treasury et payez par virement bancaire (wire) ou ACH

Purchase TDN envoie une demande à TODAQ Treasury. Vous payez par wire ou ACH, et Treasury émet les USD-TDN vers le twin.

- Où : Wallet → Purchase TDN → Buy TDN
- Qui : Tout rôle sauf Read-only
- Argent : oui

Cómo:
1. Écrivez à TODAQ à hello@qatom.ai pour indiquer que vous souhaitez acheter des USD-TDN ; vous recevrez les coordonnées bancaires.
2. Envoyez les fonds par wire ou ACH.
3. Ouvrez le twin qui doit recevoir les USD-TDN, puis allez dans Wallet → Purchase TDN → Buy TDN.
4. Saisissez le Paid Amount en USD (1 USD achète 1 TDN), ajoutez un mémo et cliquez sur Submit Request.

Ce que vous verrez : La demande apparaît comme Pending ; quand Treasury constate la réception de vos fonds, il envoie les USD-TDN et clôt la demande comme Complete.

À noter :
- Il s’agit d’une demande : les USD-TDN n’arrivent qu’après la réception de vos fonds par Treasury (S3).

Link: https://www.qatom.ai/fr/capabilities#C15

### C16. Vérifiez si votre achat d’USD-TDN est prêt

Suivez vos demandes d’achat de USD-TDN

Chaque demande d’achat a un statut. Consultez-le ici avant d’interroger Treasury au sujet d’un paiement.

- Où : Wallet → Purchase TDN
- Qui : Tout rôle

Cómo:
1. Ouvrez le twin, puis allez dans Wallet → Purchase TDN.
2. Filtrez par All, Pending, Complete ou Cancelled.
3. Lisez Date, Receiving Twin, Memo, Amount paid et Status.

Ce que vous verrez : Une demande passe de Pending à Complete lorsque Treasury émet les USD-TDN.

À noter :
- Treasury surveille votre wire ou ACH ; à sa réception, il envoie les USD-TDN et clôt la demande.

Link: https://www.qatom.ai/fr/capabilities#C16

### C17. Rapatriez les revenus de chaque article vers votre twin principal

Configurez une distribution permanente : revenus de l’article vers le twin principal

Les paiements arrivent sur le twin propre à chaque article, mais les paiements sortants et les retraits partent du principal. Une distribution permanente y transfère l’argent pour vous.

- Où : Twin fournisseur de l’article → Configuration → Distributions
- Qui : Admin

Cómo:
1. Ouvrez le twin fournisseur de l’article de catalogue, puis allez dans Configuration → Distributions → New.
2. Choisissez le token TDN.
3. Ajoutez un destinataire, l’URL du twin principal ou l’e-mail du compte, à 100 %.
4. Définissez Minimum Value (1 est la valeur standard), cochez Enabled, puis cliquez sur Save Distribution.

Ce que vous verrez : L’onglet Standing affiche la règle, et le twin principal commence à afficher des lignes Microdistribution Income.

À noter :
- Les exécutions ont lieu plusieurs fois par jour ; indiquez à vos clients que les fonds arrivent sous un jour.
- Une distribution permanente par token et par twin ; si vous choisissez à nouveau TDN, le formulaire Edit de la règle existante s’ouvre.
- Lorsqu’une distribution est active, elle remplace le bouton Send du twin.
- Si les fonds tardent, consultez l’onglet Activity du twin de l’article, puis écrivez à hello@qatom.ai.

Exemple : Le twin Create a Chess Challenge de Centaur League envoie 100 % au compte principal de la ligue, avec un minimum de 1.

Link: https://www.qatom.ai/fr/capabilities#C17

### C18. Répartissez des revenus ou payez de nombreuses personnes à la fois

Répartissez des revenus ou payez jusqu’à 200 bénéficiaires par twin ou e-mail (import CSV)

Une distribution peut payer plusieurs destinataires selon des pourcentages. Utilisez-la pour des redevances, des parts d’associés ou de nombreux gagnants de prix.

- Où : Distribution → Edit
- Qui : Admin

Cómo:
1. Ouvrez la distribution et cliquez sur Edit (ou New sur un nouveau twin).
2. Ajoutez des destinataires par URL de twin ou Email, chacun avec un Percentage ; le total doit être de 100 %.
3. Pour de nombreux bénéficiaires, cliquez sur Import CSV ; Export CSV enregistre la liste actuelle.
4. Vérifiez les destinataires et les pourcentages, puis cliquez sur Save Distribution.

Ce que vous verrez : Le formulaire de modification affiche le total des pourcentages, et la règle enregistrée liste ses destinataires.

À noter :
- Jusqu’à 200 bénéficiaires par distribution.
- Aujourd’hui, un bénéficiaire ajouté par e-mail a besoin d’un twin pour recevoir des fonds ; la connexion par e-mail à la Console arrive bientôt pour les détenteurs de twins.

Link: https://www.qatom.ai/fr/capabilities#C18

### C19. Payez une distribution immédiatement

Exécutez une distribution maintenant

Distribute Now exécute une distribution sans attendre sa prochaine exécution. Utilisez-le lorsqu’un paiement est dû aujourd’hui.

- Où : Distribution → Distribute Now
- Qui : Admin
- Argent : oui

Cómo:
1. Ouvrez Configuration → Distributions et regardez la règle.
2. Vérifiez le solde du twin, les destinataires et leurs pourcentages.
3. Cliquez sur Distribute Now.
4. Ouvrez l’onglet Activity pour voir l’exécution se terminer.

Ce que vous verrez : Une nouvelle exécution apparaît dans Activity avec sa valeur, son statut et ses heures de début et de fin.

À noter :
- Une exécution peut être terminée alors que le destinataire la voit arriver sous forme de deux dépôts à quelques minutes d’intervalle ; consultez la page de l’exécution (C20) avant de signaler un manque.
- Le propriétaire clique sur Distribute Now ; un agent ne le fait jamais.

Exemple : La première exécution de Centaur League a transféré 5 USD-TDN d’un twin d’article payant vers le principal.

Link: https://www.qatom.ai/fr/capabilities#C19

### C20. Vérifiez chaque bénéficiaire d’une exécution de distribution

Consultez les exécutions de distribution et le transfert de chaque bénéficiaire

Chaque exécution a une page qui liste chaque bénéficiaire et le transfert qui l’a payé. Utilisez-la pour répondre à "did I get paid?".

- Où : Distributions → Activity → exécution
- Qui : Admin

Cómo:
1. Ouvrez Configuration → Distributions → Activity.
2. Lisez l’ID, Value, Status, Recipients, Started et Completed de chaque exécution.
3. Cliquez sur une exécution pour voir la valeur, le statut et l’id de transfert de chaque destinataire.
4. Cliquez sur un id de transfert pour l’ouvrir dans Transfer Activity.

Ce que vous verrez : La page de l’exécution liste chaque bénéficiaire avec un statut, par exemple COMPLETED, et un lien vers le transfert.

Link: https://www.qatom.ai/fr/capabilities#C20

### C21. Facturez un service par appel

Configurez un paywall de twin (destination, prix, token)

Un paywall de twin facture chaque appel à un service https exposé par le twin. Tout article de catalogue Qatom fonctionne déjà ainsi, via son twin fournisseur.

- Où : Configuration → Paywall
- Qui : Admin

Cómo:
1. Ouvrez le twin, puis allez dans Configuration → Paywall.
2. Cochez Enabled et saisissez la Target URL (https).
3. Choisissez le Payment Token (Use TDN) et le Payment Amount, avec jusqu’à trois décimales.
4. Cliquez sur Save Configuration.

Ce que vous verrez : Le paywall est enregistré comme Enabled ; les appelants paient via l’URL du paywall du twin.

À noter :
- Donnez à chaque produit sous paywall son propre twin, avec une distribution permanente vers le principal.
- Un twin principal ne devrait pas être un paywall actif ; s’il apparaît comme Enabled avec une destination fictive, signalez-le.
- Le twin d’un article de catalogue redirige vers Qatom ; ne partagez jamais sa Target URL.

Link: https://www.qatom.ai/fr/capabilities#C21

### C22. Publiez votre paywall là où d’autres peuvent le trouver

Publiez un paywall dans le Directory ; parcourez le Directory

Un paywall public apparaît dans le Directory des paywalls du réseau. Sa page de descripteur indique aux appelants ce qu’il fait.

- Où : Descripteur du paywall + Public ; menu → Directory
- Qui : Admin ; tout le monde

Cómo:
1. Dans Configuration → Paywall, saisissez une Descriptor URL qui décrit le service.
2. Basculez l’interrupteur sur Public et cliquez sur Save Configuration.
3. Ouvrez le menu → Directory et recherchez par compte.
4. Cliquez sur Details sur une entrée pour ouvrir son descripteur.

Ce que vous verrez : Votre paywall apparaît dans le Directory sous "Public paywalls available on the network".

À noter :
- Liez une vraie page de descripteur, pas une page fictive ; le Directory affiche ce que vous liez.

Link: https://www.qatom.ai/fr/capabilities#C22

### C23. Répartissez les achats à fort volume entre twins payeurs

Ajoutez des twins payeurs à Payment Multiplex (la clé API de chaque payeur se trouve dans Dashboard → Twins)

Payment Multiplex permet à un twin maître d’attribuer chaque achat au prochain twin payeur libre. Les acheteurs n’ont affaire qu’à un seul endpoint et un seul budget.

- Où : Twin maître → Configuration → Payment Multiplex → Payers
- Qui : Admin
- Secret : nécessite un secret

Cómo:
1. Ouvrez le twin maître, puis allez dans Configuration → Payment Multiplex → Payers.
2. Dans le Qatom Dashboard, ouvrez Twins → le twin payeur et copiez sa clé API.
3. De retour dans la Console, collez la Twin URL et la clé API du payeur, puis cliquez sur Add.
4. Répétez l’opération pour chaque payeur ; prévoyez environ un payeur par achat exécuté simultanément.

Ce que vous verrez : Chaque twin payeur ajouté appartient au multiplex du maître (à confirmer : ce qu’affiche la liste Payers).

À noter :
- Les payeurs doivent appartenir au même compte ou au même groupe.
- Le propriétaire colle les clés API ; un agent ne les manipule jamais.
- (à confirmer) Ce qu’affiche la liste Payers après l’ajout d’un payeur.

Link: https://www.qatom.ai/fr/capabilities#C23

### C24. Gardez les twins payeurs approvisionnés automatiquement

Configurez les recharges du multiplex (seuil, montant)

Les recharges (Top-ups) réapprovisionnent tout twin payeur qui passe sous un seuil, à partir du solde du twin maître. Vous ne préfinancez que le maître.

- Où : Payment Multiplex → Top-ups
- Qui : Admin
- Argent : oui

Cómo:
1. Sur le twin maître, ouvrez Payment Multiplex → Top-ups et créez une nouvelle recharge.
2. Choisissez le Token ; le solde du maître s’affiche à côté.
3. Définissez Threshold et Top-up amount, cochez Enabled, puis Save.

Ce que vous verrez : La règle de recharge est enregistrée sur le twin maître (à confirmer : la façon dont elle apparaît dans la liste).

À noter :
- Les recharges s’exécutent quotidiennement et sont prélevées sur le twin maître ; préfinancez-le avec le budget total.
- Fixez le seuil à un niveau égal ou supérieur à la dépense quotidienne prévue d’un payeur.
- (à confirmer) Comment s’affichent une recharge enregistrée et chaque exécution de recharge.

Link: https://www.qatom.ai/fr/capabilities#C24

### C25. Ajoutez le compte bancaire vers lequel vous retirez

Créez le profil bancaire (États-Unis ou Canada)

Un profil bancaire enregistre les coordonnées de dépôt direct d’un twin. Il vous le faut avant de pouvoir effectuer un retrait.

- Où : Configuration → Banking Profile
- Qui : Admin
- Secret : nécessite un secret

Cómo:
1. Ouvrez le twin depuis lequel vous effectuez le retrait, puis allez dans Configuration → Banking Profile.
2. Saisissez Account Holder Name, Financial Institution Name, Country (USA ou Canada) et Account Type (Chequing ou Savings).
3. États-Unis : adresse, ville, État, code ZIP, numéro de routage à 9 chiffres et numéro de compte. Canada : numéro de transit (5–6 chiffres), numéro d’institution (3 chiffres) et numéro de compte.
4. Cliquez sur Create Profile.

Ce que vous verrez : Bank Transfer affiche alors le compte de destination masqué, avec seulement ses quatre derniers chiffres.

À noter :
- Le propriétaire du compte saisit les coordonnées bancaires ; un agent ne le fait jamais.
- Les profils sont propres à chaque twin ; configurez-en un sur le twin depuis lequel vous allez effectuer le retrait.

Link: https://www.qatom.ai/fr/capabilities#C25

### C26. Retirez des USD-TDN vers votre banque

Retirez vers la banque (minimum 10 USD-TDN, frais de $1, ACH en 2–5 jours)

Bank Transfer vend des USD-TDN à TODAQ Treasury, qui verse des dollars américains sur votre compte bancaire par ACH. Nécessite un profil bancaire et au moins 10 USD-TDN.

- Où : Page du twin → Bank Transfer
- Qui : Rôle Transfer
- Argent : oui

Cómo:
1. Transférez d’abord les revenus des articles vers le twin depuis lequel vous effectuez le retrait, en général le principal (C17).
2. Ouvrez le twin et cliquez sur Bank Transfer, puis à nouveau sur Bank Transfer.
3. Saisissez l’Amount (minimum 10) et lisez le Transfer Summary : les frais et le montant que vous recevrez.
4. Vérifiez une dernière fois la Destination Account masquée et l’Amount.
5. Cliquez sur Continue.

Ce que vous verrez : Transfer History affiche la demande comme Pending, et les USD-TDN quittent le twin immédiatement.

À noter :
- Continue envoie immédiatement ; il n’y a pas d’écran de vérification, et l’Amount peut conserver une valeur précédente.
- Des frais fixes de 1 USD s’appliquent ; un virement ACH prend de 2 à 5 jours ouvrés.
- Un retrait envoyé ne peut pas encore être annulé ; vérifiez le montant avant Continue. En cas d’erreur, écrivez à hello@qatom.ai.

Link: https://www.qatom.ai/fr/capabilities#C26

### C27. Suivez un retrait jusqu’à son paiement

Suivez un retrait

Chaque retrait correspond à une demande avec un statut. Consultez-le avant de réclamer un dépôt.

- Où : Bank Transfer → Transfer History
- Qui : Tout rôle

Cómo:
1. Ouvrez le twin, cliquez sur Bank Transfer, puis sur Transfer History.
2. Cliquez sur une demande pour voir Status, TDN Amount, Expected Payout, Created, Last Updated et Request ID.

Ce que vous verrez : La page de détail indique que les fonds seront déposés sous 2 à 5 jours ouvrés.

À noter :
- La liste peut afficher PENDING alors que la page de détail affiche Processing pour la même demande.
- Questions sur un retrait : écrivez à hello@qatom.ai.

Link: https://www.qatom.ai/fr/capabilities#C27

### C28. Renommez un twin et définissez son e-mail

Modifiez la persona du twin : nom affiché et e-mail

La persona est le visage public du twin : le nom affiché partout et un e-mail auquel d’autres peuvent payer.

- Où : Configuration → Twin Settings
- Qui : Admin

Cómo:
1. Ouvrez le twin, puis allez dans Configuration → Twin Settings.
2. Lisez Twin URL, TODA Address, Binder ID et Managing Organization.
3. Dans Persona, modifiez Display Name et Email.
4. Cliquez sur Save Changes.

Ce que vous verrez : Le nouveau Display Name apparaît comme nom du twin dans la Console.

À noter :
- L’e-mail de la persona peut recevoir des paiements : les distributions et les transferts peuvent y envoyer des fonds.

Link: https://www.qatom.ai/fr/capabilities#C28

### C29. Vérifiez qui peut voir ou déplacer les fonds d’un twin

Voyez qui a accès à un twin

L’accès est accordé twin par twin. Cette page devrait indiquer qui détient chaque rôle.

- Où : Account → Permissions (menu de gauche)
- Qui : Admin

Cómo:
1. Ouvrez le twin, puis allez dans Configuration → Permissions.
2. Lisez qui dispose du rôle Admin, Transfer ou Read-only sur le twin.

Ce que vous verrez : (à confirmer) Une liste des personnes et de leur rôle sur le twin.

À noter :
- Aujourd’hui, cette page renvoie une erreur 403 même pour les Admin du twin ; demandez au propriétaire du compte qui y a accès.
- Rôles : Admin configure, Transfer peut envoyer, Read-only peut seulement consulter.

Link: https://www.qatom.ai/fr/capabilities#C29

### C30. Vérifiez l’utilisation d’un twin

Consultez l’utilisation (fichiers, transactions, stockage)

Usage indique combien un twin stocke et combien il a traité par rapport à une allocation standard. Utile lorsque vous examinez un twin très actif.

- Où : Configuration → Usage
- Qui : Admin

Cómo:
1. Ouvrez le twin, puis allez dans Configuration → Usage.
2. Lisez les fichiers, les transactions et le stockage par rapport à l’allocation standard (25 fichiers, 1 250 transactions, 100 Mo).
3. Lisez les décomptes Inbox, Rejected et Unowned.

Ce que vous verrez : Un chiffre Overall indique l’utilisation en multiple de l’allocation standard, par exemple 0,3x.

À noter :
- Ce sont des indicateurs de santé internes ; aucune limite n’est appliquée aux clients aujourd’hui.
- Unowned compte la dernière preuve de chaque fichier que le twin détenait avant son passage à un nouveau détenteur.

Link: https://www.qatom.ai/fr/capabilities#C30

### C32. Reconnectez-vous pour appliquer un nouveau rôle

Déconnectez-vous et reconnectez-vous après un changement de rôle

Un changement de rôle ne s’applique qu’à votre prochaine connexion. Déconnectez-vous et reconnectez-vous après qu’un propriétaire a modifié votre accès.

- Où : Menu utilisateur → Sign out
- Qui : Tout le monde

Cómo:
1. Ouvrez le menu utilisateur et cliquez sur Sign out.
2. Reconnectez-vous (C1).

Ce que vous verrez : Les commandes correspondent désormais à votre nouveau rôle ; par exemple, Send s’active une fois que vous avez reçu le rôle Transfer.

À noter :
- La Console ne vous prévient pas qu’un rôle a changé ; déconnectez-vous et reconnectez-vous lorsqu’un propriétaire vous le demande.
- Avant de vous reconnecter, certains twins peuvent apparaître sans nom ni solde.

Link: https://www.qatom.ai/fr/capabilities#C32

### C33. Voyez ce qui a changé dans la Console

Lisez les nouveautés

La Console évolue souvent. Release Notes liste chaque version et ce qu’elle a ajouté.

- Où : Menu → Release Notes
- Qui : Tout le monde

Cómo:
1. Ouvrez le menu et cliquez sur Release Notes.
2. Lisez la date et les changements de chaque version.

Ce que vous verrez : Une liste des versions de la Console avec leurs dates, par exemple v2.6.0 (28 sept. 2026), qui a ajouté Transfer Activity.

À noter :
- Si un écran diffère de ce guide, fiez-vous à l’écran.

Link: https://www.qatom.ai/fr/capabilities#C33

## Partagées (entre les parcours)

Des capacités communes à plusieurs parcours, ou qui se déroulent du côté de TODAQ et sont présentées pour que vous sachiez à quoi vous attendre.

### S1. Profitez d’une offre Qatom à l’inscription

Inscrivez-vous et réclamez une offre (p. ex. un essai Max ou un code promo)

Qatom propose parfois une offre gratuite pour une durée limitée, par exemple un essai Max de 60 jours, ou six mois de Max pour les Agentic Payments Builders disposant d’un code promo préapprouvé. Vous la réclamez depuis sa page sur qatom.ai.

- Où : Page de l’offre sur qatom.ai, puis la connexion Qatom et dashboard.qatom.ai/onboarding
- Qui : Tout le monde

Cómo:
1. Ouvrez la page de l’offre sur qatom.ai qui vous a été communiquée et réclamez l’offre.
2. Inscrivez-vous ou connectez-vous avec la même adresse e-mail (B34).
3. L’équipe Qatom enregistre l’offre sur votre compte.

Ce que vous verrez : Votre compte s’ouvre dans le Dashboard. L’offre n’apparaît pas encore dans le Dashboard ; demandez à l’équipe Qatom de la confirmer.

À noter :
- Il est possible que Settings → Billing n’affiche pas encore d’offre active.

Exemple : Des participants à des événements ont reçu six mois de Max gratuits via une page d’offre sur qatom.ai.

Link: https://www.qatom.ai/fr/capabilities#S1

### S2. Appelez l’API Qatom depuis votre serveur

Utilisez les identifiants client (B30) pour les appels côté serveur (paiements, transactions)

Votre serveur utilise les identifiants client du compte pour obtenir un jeton pour les appels à l’API, comme les paiements ou savoir qui a payé. Ils ne quittent jamais le serveur.

- Où : Dashboard → Settings → Secrets ; jeton depuis /v4/account/oauth/token
- Qui : Vendeur
- Secret : nécessite un secret

Cómo:
1. Dans le Dashboard, ouvrez Settings → Secrets.
2. Dans Client credentials, copiez le Client ID, puis utilisez Reveal et copiez le Client secret.
3. Conservez-les tous deux dans le coffre de secrets de votre serveur, jamais dans un navigateur, une app ou un dépôt.
4. Votre serveur les échange contre un jeton de compte sur /v4/account/oauth/token, puis appelle l’API.

Ce que vous verrez : Votre serveur obtient un jeton de compte et ses appels à l’API fonctionnent.

À noter :
- Le Public secret est différent : il peut être publié et il est utilisé par les embeds et le guest checkout.
- Les transferts sont débités du twin principal ; transférez-y d’abord les revenus des articles (C17).
- Un /v4/transfer qui renvoie 202 a déjà déplacé l’argent ; ne le relancez jamais.

Exemple : Le serveur de Centaur League détermine qui a payé à partir des transactions de commodity et paie les gagnants avec /v4/transfer.

Link: https://www.qatom.ai/fr/capabilities#S2

### S6. Consultez n’importe quel appel de l’API Qatom

Lisez la référence de l’API et l’OpenAPI

La référence de l’API et le document OpenAPI décrivent chaque endpoint v4. Les développeurs s’en servent pour le travail côté serveur et pour générer des clients.

- Où : docs.qatom.ai, https://pay.m.todaq.net/v4/openapi.json
- Qui : Desarrollador

Cómo:
1. Ouvrez docs.qatom.ai pour consulter la référence de l’API.
2. Téléchargez le document OpenAPI depuis https://pay.m.todaq.net/v4/openapi.json.
3. Pour obtenir une liste publique des articles, appelez GET /v4/catalog/items, par exemple pour créer votre llms.txt.

Ce que vous verrez : Le document OpenAPI (TODAQ Micro Payment API 4.0.0) liste chaque endpoint avec sa méthode et son chemin.

À noter :
- Si un guide ou un skill diffère de l’OpenAPI publié, c’est l’OpenAPI qui fait foi.

Link: https://www.qatom.ai/fr/capabilities#S6

### S10. Une ligne gratuite vers Team Kepler, bientôt disponible

Article de retours Team Kepler (bientôt disponible) : aide, évaluations, escalade des remboursements et idées

Un article de catalogue gratuit permettra de joindre Team Kepler et acheminera chaque message selon son sujet : aide et onboarding vers Wizard Kepler ; retours sur les outils, évaluations et escalade des remboursements vers Pirate Kepler ; idées et risques du marché vers Agent Kepler. Il n’est pas encore dans le catalogue ; en attendant, utilisez l’article de retours du vendeur et hello@qatom.ai (A27).

- Où : Catalogue Team Kepler sur Qatom
- Qui : Tout le monde

Cómo:
1. Demandez à votre agent de chercher Team Kepler dans le catalogue (catalog_search).
2. S’il apparaît, appelez-le avec agent_checkout ; c’est gratuit.
3. Choisissez le sujet (aide, remboursement, évaluation ou idée) et rédigez votre message.
4. Pour un remboursement, indiquez l’id de la transaction et précisez que le vendeur n’a pas répondu.

Ce que vous verrez : (à confirmer) Le reçu renvoie une référence pour votre message.

À noter :
- (à confirmer) Le nom exact de l’article et ses données d’entrée ; sa spécification est en cours de finalisation.
- En attendant, écrivez à hello@qatom.ai.

Link: https://www.qatom.ai/fr/capabilities#S10

### S11. Chaque connexion et chaque approbation en un seul geste

Configurez une passkey (fortement recommandé)

Qatom vous demande de vous connecter chaque fois que c’est important : connecter votre IA, choisir un compte vendeur, approuver un achat au-delà de votre limite ou une modification du compte. Avec une passkey (clé d’accès), chacune de ces actions se fait d’un geste ou avec votre empreinte, au lieu d’attendre un code par e-mail. Elle reste sur votre propre appareil.

- Où : Écran d’inscription et de connexion Qatom (pay.m.todaq.net)
- Qui : Toute personne disposant d’un compte Qatom

Cómo:
1. La première fois que vous vous connectez avec un code par e-mail, Qatom vous propose "Sign in faster" : cliquez sur Set up a passkey.
2. Votre appareil vous propose d’enregistrer la passkey (sur un Mac, dans Passwords) ; confirmez avec votre empreinte ou votre mot de passe.
3. La prochaine fois qu’une page Qatom vous demande de vous connecter (pour connecter, choisir un compte vendeur ou approuver), choisissez Sign in with a passkey.
4. Enregistrez-en une sur chaque appareil depuis lequel vous approuvez, comme votre ordinateur portable et votre téléphone.

Ce que vous verrez : Les pages de connexion et d’approbation se valident d’un seul geste.

À noter :
- La Console (console.todaq.net) a sa propre connexion, avec ses propres passkeys (Account → Passkeys, C2) ; la passkey de votre connexion Qatom n’y fonctionne pas.
- Vous seul créez ou utilisez votre passkey ; un agent ne le fait jamais.

Link: https://www.qatom.ai/fr/capabilities#S11

