Comment les agents IA achètent des cartes-cadeaux avec des stablecoins

Comment les agents IA achètent des cartes-cadeaux avec des stablecoins

La plupart des intégrations API supposent qu'un humain est quelque part dans le processus. Elles sont construites autour de comptes, de flux OAuth, de clés préémises et d'interfaces de paiement, car jusqu'à récemment, les logiciels qui avaient besoin d'acheter quelque chose n'avaient pas de moyen propre de le faire de manière autonome.

Cela évolue. Ce que les gens appellent le commerce agentique est le modèle où des logiciels autonomes peuvent découvrir, évaluer et acheter des biens sans attendre qu'un humain confirme chaque étape. C'est un modèle différent de l'intégration API traditionnelle d'une manière fondamentale : l'agent ne se préenregistre pas, ne détient pas de jeton de session et ne redirige personne vers un écran de paiement.

Les cartes-cadeaux s'intègrent naturellement ici. Elles sont numériques, elles peuvent être émises instantanément et ne nécessitent pas d'expédition ni de vérification d'identité du côté de l'acheteur. Cet article couvre le fonctionnement de l'infrastructure et comment la configurer.
 

Les trois protocoles que vous devez comprendre

MCP (Model Context Protocol)

MCP est la couche qui permet à un modèle IA d'appeler des outils externes. Au lieu que votre code accède directement à une API, l'agent appelle un outil nommé, le serveur MCP traduit cela en la bonne requête, et le résultat revient dans un format que le modèle peut analyser. Pour les achats de cartes-cadeaux, cela signifie que l'agent peut appeler searchProducts, getProductPrice, validateOrder et createOrder comme des appels d'outils naturels plutôt que des appels HTTP bruts.

Le serveur MCP de Cryptorefills est publié à api.cryptorefills.com/mcp et est auto-découvrable via le manifeste /.well-known/mcp.json, de sorte que les clients compatibles MCP, y compris Claude et ChatGPT, peuvent se connecter sans aucun code de liaison personnalisé. Consultez le guide d'intégration MCP pour l'histoire de sa création.
 

x402 (paiement natif HTTP)

x402 est une norme de paiement ouverte qui réactive le code d'état HTTP 402 longtemps inactif. Le flux fonctionne comme suit : un agent fait une demande à une ressource, le serveur répond avec 402 Payment Required et une charge utile lisible par machine spécifiant le prix, l'actif accepté et l'adresse cible. L'agent signe une autorisation de paiement en utilisant EIP-712 (sur les chaînes EVM) ou l'équivalent sur Solana, puis réessaie la demande avec un en-tête X-PAYMENT. Pas de création de compte, pas d'OAuth, pas de clé API préfinancée.

Pour la compétence cryptorefills-x402 spécifiquement, l'actif est USDC sur Base et le paiement est sans frais via des transferts signés EIP-712.
 

API REST

Pour les développeurs qui souhaitent une intégration directe plutôt que des appels d'outils MCP, l'API REST de Cryptorefills couvre l'ensemble du cycle de vie des commandes. Navigation dans le catalogue via /v2/brands et /v5/products/country, tarification juste à temps via /v4/products/price, validation des commandes via /v5/orders/validations, création de commandes via /v5/orders, et suivi post-création via streaming ou polling.

C'est le bon chemin si vous construisez un cadre d'agent personnalisé, une mini-application Telegram ou un paiement intégré dans un portefeuille et souhaitez un contrôle total sur le flux de requêtes. La documentation complète des points de terminaison se trouve sur api-docs.
 

Étape par étape : un agent IA achetant une carte-cadeau Amazon de 50 $ avec USDC sur Solana

Voici à quoi ressemble un achat autonome complet de bout en bout, en utilisant Claude Desktop avec le serveur MCP de Cryptorefills installé.

Étape 1 : Ajouter le serveur MCP à Claude Desktop

Dans votre claude_desktop_config.json, ajoutez :
 

{  "mcpServers": {    "cryptorefills": {      "url": "https://api.cryptorefills.com/mcp/http",      "transport": "http",      "headers": {        "User-Agent": "Cryptorefills-MCP/1.0"      }    }  }}

Le champ transport: "http" utilise HTTP en streaming plutôt que stdio, ce qui signifie que la connexion reste ouverte tout au long d'un flux d'achat multi-étapes sans créer un nouveau processus pour chaque appel d'outil. Aucune clé API n'est requise dans l'en-tête pour les opérations de catalogue et de tarification.
 

Étape 2 : L'agent appelle searchProducts

{  "tool": "searchProducts",  "input": {    "query": "Amazon",    "country": "US",    "category": "gift_cards"  }}

Le serveur renvoie une liste de produits correspondants avec leurs ID, dénominations disponibles et rails de paiement pris en charge.
 

Étape 3 : L'agent appelle getProductPrice

{  "tool": "getProductPrice",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana"  }}

Cela renvoie l'équivalent en USDC de 50 $ aux taux actuels, ainsi qu'une fenêtre de validité de l'offre. La tarification est obtenue juste à temps afin que l'agent ne paie jamais contre un taux obsolète.
 

Étape 4 : L'agent appelle validateOrder, puis createOrder

La validation s'exécute d'abord afin que l'agent puisse détecter tout problème d'adresse de livraison ou de disponibilité du produit avant de s'engager. En cas de succès :
 

{  "tool": "createOrder",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana",    "delivery_email": "user@example.com"  }}

Étape 5 : Réponse de la commande

{  "order_id": "cr_ord_9f3a12b",  "status": "awaiting_payment",  "payment": {    "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA7SjTBRet7vQ9z",    "amount": "50.23",    "currency": "USDC",    "network": "solana",    "expires_at": "2026-04-23T14:35:00Z"  },  "product": {    "name": "Carte-cadeau Amazon",    "denomination": 50,    "currency": "USD"  }}

Une fois le paiement reçu à l'adresse dans la fenêtre d'expiration, le statut de la commande passe à "terminé" et le bon est livré. L'agent peut diffuser des mises à jour de statut via le point de terminaison /track-order-stream ou revenir au polling.
 

À quoi les agents utilisent réellement cela

Bots de marché de portefeuille. Un utilisateur dit au bot quelle marque il veut. Le bot propose un prix en USDC, exécute et diffuse le statut de livraison, le tout dans l'interface du portefeuille.

Assistants de mini-app Telegram. Flux d'achat conversationnels où l'agent gère la recherche de marque, la sélection de dénomination et la validation de paiement, avec des garde-fous pour éviter les doubles commandes.

Agents de récompenses DAO. La participation à la gouvernance en chaîne, les contributions communautaires ou les réalisations de primes sont récompensées par des bons de cartes-cadeaux émis de manière autonome à partir d'un portefeuille de trésorerie.

Aides aux dépenses de trésorerie. Les équipes dépensant à partir d'une trésorerie stable partagée peuvent automatiser l'acquisition contrôlée et vérifiable de cartes-cadeaux sans étapes manuelles de conversion en fiat.

Pour un aperçu plus long de la logique d'incitation derrière les agents émettant des récompenses aux humains, consultez Quand les IA commencent à acheter des cartes-cadeaux.
 

Pourquoi ne pas simplement construire votre propre couche de paiement

L'alternative tentante est de combiner un processeur de paiement, une API de cartes-cadeaux et un point de conversion en fiat vous-même. En pratique, cela signifie gérer des soldes préfinancés avec un fournisseur tiers, naviguer dans les restrictions géographiques sur la disponibilité des cartes-cadeaux, absorber la latence et la complexité des rails fiat, et maintenir votre propre synchronisation de catalogue.

Cryptorefills élimine tout cela. Aucun préfinancement requis, aucune conversion en fiat dans le chemin critique, et le catalogue couvre plus de 6 600 marques dans plus de 180 pays, disponible dès que votre agent appelle searchProducts. La page des agents IA a un aperçu complet des compétences disponibles et des options de connexion.
 

Questions fréquentes

Claude peut-il acheter des cartes-cadeaux ?

Oui. Claude prend en charge le MCP nativement via Claude Desktop et Claude Code. Ajoutez le serveur MCP de Cryptorefills à votre configuration (voir le snippet ci-dessus) et Claude peut rechercher dans le catalogue, obtenir un prix en direct, valider et créer une commande en une seule conversation. Aucun clé API ou compte séparé n'est requis pour l'accès au catalogue et à la tarification.
 

Qu'est-ce que x402 ?

x402 est une norme de paiement HTTP ouverte qui réutilise le code d'état HTTP 402 afin qu'un serveur puisse déclarer son prix et son mode de paiement accepté. Pour les agents autonomes, cela signifie effectuer des achats sans comptes préenregistrés ou jetons OAuth. La compétence cryptorefills-x402 met cela en œuvre pour des achats entièrement autonomes.
 

Comment les agents IA dépensent-ils de l'argent ?

Un agent a besoin de trois choses : un portefeuille approvisionné (détenant généralement des stablecoins comme USDC ou USDT), un moyen d'appeler des services externes (appels d'outils MCP ou appels API directs), et un mécanisme de paiement qui ne nécessite pas d'humain au moment de la transaction. x402 gère la dernière partie en intégrant la poignée de paiement dans HTTP. Sans quelque chose comme x402 ou MCP, un agent peut préparer une commande mais ne peut pas finaliser le paiement de manière autonome.
 

Y a-t-il un serveur MCP pour les cartes-cadeaux ?

Oui. Cryptorefills publie un serveur MCP qui gère les outils pour la recherche de catalogue, la tarification, la validation de commande, la création de commande et le suivi de livraison. Il fonctionne avec tout client compatible MCP, y compris Claude et ChatGPT.
 

Commencer

Connectez votre agent à plus de 6 600 marques de cartes-cadeaux dans plus de 180 pays. Pas de KYC. Pas de préfinancement.

Ajoutez le serveur MCP directement dans Claude Desktop, Claude Code ou tout environnement d'exécution d'agent compatible MCP.
 

npx skills add cryptorefills/agents

Ouvrez la page des agents IA pour voir les trois compétences, la configuration de la compétence x402 et la liste complète des réseaux de paiement pris en charge.