Come gli agenti AI acquistano carte regalo con stablecoin

Come gli agenti AI acquistano carte regalo con stablecoin

La maggior parte delle integrazioni API presuppone che ci sia un umano coinvolto nel processo. Sono costruite attorno a account, flussi OAuth, chiavi pre-emesse e interfacce di checkout, perché fino a poco tempo fa, il software che doveva acquistare qualcosa non aveva un modo pulito per farlo autonomamente.

Questo sta cambiando. Ciò che le persone chiamano commercio agentico è il modello in cui il software autonomo può scoprire, valutare e acquistare beni senza attendere che un umano confermi ogni passaggio. È un modello diverso dall'integrazione API tradizionale in un modo fondamentale: l'agente non si registra in anticipo, non detiene un token di sessione e non reindirizza nessuno a una schermata di pagamento.

Le carte regalo si adattano naturalmente a questo contesto. Sono digitali, possono essere emesse istantaneamente e non richiedono spedizione o verifica dell'identità da parte dell'acquirente. Questo articolo tratta di come funziona l'infrastruttura e come configurarla.
 

I tre protocolli che devi comprendere

MCP (Model Context Protocol)

MCP è il livello che consente a un modello AI di chiamare strumenti esterni. Invece che il tuo codice colpisca direttamente un'API, l'agente chiama uno strumento nominato, il server MCP traduce questo nella richiesta corretta e il risultato torna in un formato che il modello può elaborare. Per gli acquisti di carte regalo, questo significa che l'agente può chiamare searchProducts, getProductPrice, validateOrder e createOrder come chiamate naturali agli strumenti piuttosto che come chiamate HTTP grezze.

Il server MCP di Cryptorefills è pubblicato su api.cryptorefills.com/mcp ed è auto-scopribile tramite il manifesto /.well-known/mcp.json, quindi i client compatibili con MCP, tra cui Claude e ChatGPT, possono connettersi senza alcun codice di collegamento personalizzato. Consulta la guida all'integrazione MCP per la storia di costruzione dietro di essa.
 

x402 (pagamento nativo HTTP)

x402 è uno standard di pagamento aperto che riattiva il codice di stato HTTP 402, a lungo inattivo. Il flusso funziona in questo modo: un agente fa una richiesta a una risorsa, il server risponde con 402 Payment Required e un payload leggibile dalla macchina che specifica il prezzo, l'asset accettato e l'indirizzo target. L'agente firma un'autorizzazione di pagamento utilizzando EIP-712 (su catene EVM) o l'equivalente su Solana, quindi ripete la richiesta con un'intestazione X-PAYMENT. Nessuna creazione di account, nessun OAuth, nessuna chiave API prefinanziata.

Per la skill cryptorefills-x402 in particolare, l'asset è USDC su Base e il pagamento è senza gas tramite trasferimenti firmati EIP-712.
 

REST API

Per i costruttori che desiderano un'integrazione diretta piuttosto che chiamate agli strumenti MCP, l'API REST di Cryptorefills copre l'intero ciclo di vita degli ordini. Navigazione del catalogo tramite /v2/brands e /v5/products/country, pricing just-in-time tramite /v4/products/price, validazione degli ordini tramite /v5/orders/validations, creazione degli ordini tramite /v5/orders e tracciamento post-creazione tramite streaming o polling.

Questo è il percorso giusto se stai costruendo un framework di agenti personalizzati, un mini-app di Telegram o un checkout integrato nel wallet e desideri il pieno controllo sul flusso delle richieste. La documentazione completa degli endpoint è disponibile su api-docs.
 

Passo dopo passo: un agente AI che acquista una carta regalo Amazon da $50 con USDC su Solana

Ecco come appare un acquisto autonomo completo dall'inizio alla fine, utilizzando Claude Desktop con il server MCP di Cryptorefills installato.

Passo 1: Aggiungi il server MCP a Claude Desktop

Nel tuo claude_desktop_config.json, aggiungi:
 

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

Il campo transport: "http" utilizza HTTP streamabile piuttosto che stdio, il che significa che la connessione rimane aperta durante un flusso di acquisto multi-passaggio senza avviare un nuovo processo per ogni chiamata allo strumento. Non è necessaria alcuna chiave API nell'intestazione per le operazioni di catalogo e pricing.
 

Passo 2: L'agente chiama searchProducts

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

Il server restituisce un elenco di prodotti corrispondenti con i loro ID, le denominazioni disponibili e i metodi di pagamento supportati.
 

Passo 3: L'agente chiama getProductPrice

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

Questo restituisce l'equivalente in USDC di $50 ai tassi attuali, insieme a una finestra di validità della quotazione. I prezzi vengono recuperati giusto in tempo, quindi l'agente non paga mai contro un tasso obsoleto.
 

Passo 4: L'agente chiama validateOrder, poi createOrder

La validazione viene eseguita prima in modo che l'agente possa rilevare eventuali problemi di indirizzo di consegna o disponibilità del prodotto prima di impegnarsi. In caso di successo:
 

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

Passo 5: Risposta dell'ordine

{  "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": "Amazon Gift Card",    "denomination": 50,    "currency": "USD"  }}

Una volta che il pagamento arriva all'indirizzo entro la finestra di scadenza, lo stato dell'ordine passa a completato e il voucher viene consegnato. L'agente può trasmettere aggiornamenti di stato tramite l'endpoint /track-order-stream o tornare al polling.
 

Cosa stanno effettivamente usando gli agenti per questo

Bot di marketplace per wallet. Un utente dice al bot quale marca desidera. Il bot fornisce un prezzo in USDC, esegue l'operazione e trasmette lo stato di consegna, tutto all'interno dell'interfaccia del wallet.

Assistenti mini app di Telegram. Flussi di acquisto conversazionali in cui l'agente gestisce la ricerca del marchio, la selezione della denominazione e la validazione del pagamento, con misure di sicurezza per prevenire ordini doppi.

Agenti di ricompensa DAO. La partecipazione alla governance on-chain, i contributi alla comunità o il completamento di bounty vengono premiati con voucher per carte regalo emessi autonomamente da un wallet di tesoreria.

Helper per spese di tesoreria. I team che spendono da un tesoreria di stablecoin condivisa possono automatizzare l'acquisto controllato e auditabile di carte regalo senza passaggi manuali di conversione fiat.

Per uno sguardo più approfondito sulla logica degli incentivi dietro gli agenti che emettono ricompense agli esseri umani, consulta Quando le AI iniziano a comprare carte regalo.
 

Perché non costruire semplicemente il tuo strato di pagamento

L'alternativa allettante è combinare un processore di pagamento, un'API per carte regalo e un'uscita fiat da solo. In pratica, ciò significa gestire saldi prefinanziati con un fornitore terzo, navigare nelle restrizioni geografiche sulla disponibilità delle carte regalo, assorbire la latenza e la complessità dei percorsi fiat e mantenere la sincronizzazione del catalogo.

Cryptorefills rimuove tutto questo. Non è richiesto alcun prefinanziamento, nessuna conversione fiat nel percorso critico e il catalogo copre oltre 6.600 marchi in oltre 180 paesi, disponibili nel momento in cui il tuo agente chiama searchProducts. La pagina degli agenti AI offre una panoramica completa delle skill disponibili e delle opzioni di connessione.
 

Domande frequenti

Claude può acquistare carte regalo?

Sì. Claude supporta nativamente MCP tramite Claude Desktop e Claude Code. Aggiungi il server MCP di Cryptorefills alla tua configurazione (vedi il frammento sopra) e Claude può cercare nel catalogo, ottenere un prezzo live, validare e creare un ordine in una singola conversazione. Non è necessaria alcuna chiave API separata o account per l'accesso al catalogo e alla pricing.
 

Cos'è x402?

x402 è uno standard di pagamento HTTP aperto che riutilizza il codice di stato HTTP 402 in modo che un server possa dichiarare il proprio prezzo e il metodo di pagamento accettato. Per gli agenti autonomi, questo significa effettuare acquisti senza account pre-registrati o token OAuth. La skill cryptorefills-x402 implementa questo per acquisti completamente autonomi.
 

Come spendono soldi gli agenti AI?

Un agente ha bisogno di tre cose: un wallet finanziato (tipicamente contenente stablecoin come USDC o USDT), un modo per chiamare servizi esterni (chiamate agli strumenti MCP o chiamate API dirette) e un meccanismo di pagamento che non richieda un umano al momento della transazione. x402 gestisce l'ultima parte incorporando la stretta di pagamento all'interno di HTTP. Senza qualcosa come x402 o MCP, un agente può preparare un ordine ma non può completare il pagamento autonomamente.
 

Esiste un server MCP per le carte regalo?

Sì. Cryptorefills pubblica un server MCP che gestisce strumenti per la ricerca del catalogo, la pricing, la validazione degli ordini, la creazione degli ordini e il tracciamento delle consegne. Funziona con qualsiasi client compatibile con MCP, inclusi Claude e ChatGPT.
 

Inizia

Collega il tuo agente a oltre 6.600 marchi di carte regalo in oltre 180 paesi. Nessun KYC. Nessun prefinanziamento.

Aggiungi direttamente il server MCP in Claude Desktop, Claude Code o in qualsiasi runtime di agente compatibile con MCP.
 

npx skills add cryptorefills/agents

Apri la pagina degli agenti AI per vedere tutte e tre le skill, la configurazione della skill x402 e l'elenco completo delle reti di pagamento supportate.