Comment les agents IA achètent des cartes-cadeaux sur Solana
Depuis la sortie de notre récent Cryptorefills x402, les agents IA peuvent désormais acheter des cartes-cadeaux et des recharges mobiles sur Solana dans notre catalogue, en réglant les paiements en USDC (sans intervention humaine à aucun moment de la transaction). Cet article explique comment cela fonctionne en pratique.
Qu'est-ce que x402 ?
x402 est un protocole de paiement basé sur le code d'état HTTP 402, un statut qui fait partie de la norme web depuis 1996 mais qui n'a jamais été réellement utilisé pour les paiements jusqu'à présent. Tout d'abord, un serveur indique au client qu'un paiement est requis, le client signe une transaction et renvoie la demande, puis le serveur livre une fois le paiement confirmé. L'ensemble du processus se déroule en un seul échange, sans redirection vers une page de paiement et sans qu'aucune approbation humaine ne soit nécessaire.
Sur Solana, cet échange se règle en USDC en moins de 400 ms. Assez rapide pour que l'agent reçoive une réponse confirmée dans la même étape où il a effectué l'achat, ce qui maintient l'implémentation simple et le flux ininterrompu.
Cryptorefills sur x402
Cryptorefills a construit le côté marchand de cela. Grâce à l'intégration des agents IA, tout agent compatible avec x402 peut accéder à l'intégralité du catalogue de Cryptorefills : des cartes-cadeaux de plus de 6 600 marques, des recharges mobiles dans 180 pays, et le même inventaire de produits disponible pour les utilisateurs réguliers, le tout sans avoir besoin d'une session de navigateur ou d'un humain pour finaliser le paiement.
La configuration de pay.sh
pay.sh est un shell d'agent natif de Solana, et l'intégration de Cryptorefills est livrée sous forme de plugin pour celui-ci. La configuration nécessite trois commandes :
Étape 1 : Installer la compétence Cryptorefills
Dans un environnement compatible avec les plugins pay.sh, la configuration se fait en trois commandes :
/plugin marketplace add cryptorefills/agents/plugin install cryptorefills@cryptorefills-skills/plugin reload
Après le rechargement, l'agent a accès à l'intégralité de l'inventaire de produits de Cryptorefills et à la logique de paiement sous-jacente pour interagir avec via x402.
Étape 2 : L'agent effectue l'achat
Essayez d'utiliser cette invite :
"Utilisez vos compétences pour acheter une carte-cadeau Amazon.com de 5 $ aux États-Unis en utilisant Solana USDC.Utilisez l'email info@cryptorefills.com comme bénéficiaire. Montrez également le code produit de lacarte-cadeau Amazon dans cette discussion. Vous pouvez trouver la clé privée du portefeuilledans le fichier .env sous SOLANA_SIGNER_KEY ne jamais exposer cette valeur."
L'agent récupère la clé privée du fichier .env (sous SOLANA_SIGNER_KEY), signe la transaction de paiement x402, la soumet à Solana et attend la confirmation. Une fois le paiement validé, Cryptorefills livre le code de la carte-cadeau que l'agent affiche ensuite directement dans la conversation du terminal.
Pourquoi Solana pour cela
La rapidité et le coût sont les réponses évidentes, mais il y a plus que cela. La finalité des transactions sur Solana est suffisamment rapide pour que x402 puisse réellement fonctionner de manière synchrone dans un flux de travail d'agent. L'agent envoie le paiement, le marchand le confirme, et la réponse revient dans le même "tour" de la boucle de raisonnement de l'agent.
Comparez cela à la tentative de faire la même chose sur une chaîne plus lente où les temps de confirmation s'étendent sur des dizaines de secondes ou des minutes. À ce stade, vous introduisez une complexité asynchrone, une logique de réessai, et un potentiel d'états échoués qui sont réellement difficiles à gérer avec grâce dans des contextes d'agents.
USDC sur Solana contourne également le problème de la volatilité. L'agent dépense un jeton libellé en dollars à un taux prévisible, ce qui est important lorsque l'achat est une carte-cadeau de 5 $ et non un transfert de trésorerie important.
Ce que Cryptorefills permet ici
La page des agents IA documente ce qui est réellement disponible grâce à l'intégration : des cartes-cadeaux de centaines de marques, des recharges mobiles dans plus de 170 pays, et des paiements de factures dans certains marchés. Le catalogue est le même que celui auquel les utilisateurs humains ont accès, juste exposé via une API et une couche de paiement que les agents peuvent réellement utiliser sans session utilisateur.
Quelques points à savoir :
L'inventaire et la disponibilité varient selon la région. Un agent construisant un flux d'achat devrait vérifier la disponibilité des produits de manière dynamique plutôt que de supposer un catalogue statique. L'API gère cela.
L'email du bénéficiaire est la manière dont Cryptorefills achemine la livraison numérique. Dans les flux automatisés, il s'agit généralement d'un email système auquel l'agent a accès, ou d'un email configuré au moment de la configuration.
La gestion de la clé privée montrée dans la démonstration (lecture depuis .env) est un modèle de développement. Les déploiements en production devraient utiliser un gestionnaire de secrets approprié plutôt que des fichiers d'environnement sur disque, car c'est la pratique standard pour tout ce qui gère des clés de portefeuille.
L'intégralité du catalogue est documentée sur la page des agents IA de Cryptorefills. Des cartes-cadeaux de centaines de marques aux États-Unis et à l'international, des recharges mobiles dans plus de 180 pays, et des paiements de factures dans certains marchés. La disponibilité varie selon la région, donc les agents devraient vérifier ce qui est en stock via l'API au moment de l'achat plutôt que de supposer une liste fixe.
La carte Amazon de 5 $ dans l'exemple est la version la plus simple du modèle. Le même flux fonctionne pour tout le reste du catalogue.
Pour qui est-ce ?
Pour les développeurs construisant des agents qui ont besoin de dépenser de l'argent au nom des utilisateurs ou dans le cadre de flux de travail automatisés. Un bot de service client qui émet une carte-cadeau en compensation. Un flux de travail qui distribue des recharges aux utilisateurs sans exécution manuelle. Un assistant qui gère les achats au nom d'un utilisateur. L'intégration Cryptorefills x402 gère le paiement et la livraison du produit ; le développeur connecte la logique métier autour.
pay.sh cible les agents fonctionnant dans des environnements de terminal, où l'interaction est du texte en entrée, résultat en sortie. La vidéo ci-dessous montre l'ensemble du flux, de l'installation du plugin à la livraison du code de la carte-cadeau dans la discussion.