Como Agentes de IA Compram Cartões-Presente com Stablecoins

Como agentes de IA compram cartões-presente com stablecoins

A maioria das integrações de API assume que um humano está em algum lugar do processo. Elas são construídas em torno de contas, fluxos de OAuth, chaves pré-emissas e interfaces de checkout, porque até recentemente, o software que precisava comprar algo não tinha uma maneira clara de fazer isso por conta própria.

Isso está mudando. O que as pessoas estão chamando de comércio autônomo é o padrão onde software autônomo pode descobrir, precificar e comprar bens sem esperar que um humano confirme cada etapa. É um modelo diferente da integração tradicional de API de uma maneira fundamental: o agente não se pré-registra, não mantém um token de sessão e não redireciona ninguém para uma tela de pagamento.

Os cartões-presente se encaixam naturalmente aqui. Eles são digitais, podem ser emitidos instantaneamente e não requerem envio ou verificação de identidade do lado do comprador. Este artigo cobre como a infraestrutura funciona e como configurá-la.
 

Os três protocolos que você precisa entender

MCP (Modelo de Contexto de Protocolo)

O MCP é a camada que permite que um modelo de IA chame ferramentas externas. Em vez de seu código acessar uma API diretamente, o agente chama uma ferramenta nomeada, o servidor MCP traduz isso na solicitação correta e o resultado retorna em um formato que o modelo pode raciocinar. Para compras de cartões-presente, isso significa que o agente pode chamar searchProducts, getProductPrice, validateOrder e createOrder como chamadas de ferramentas naturais em vez de chamadas HTTP brutas.

O servidor MCP da Cryptorefills está publicado em api.cryptorefills.com/mcp e é auto-descoberto através do manifesto /.well-known/mcp.json, então clientes compatíveis com MCP, incluindo Claude e ChatGPT, podem se conectar sem nenhum código adicional. Veja o guia de integração do MCP para a história de construção por trás disso.
 

x402 (pagamento nativo em HTTP)

x402 é um padrão de pagamento aberto que reativa o código de status HTTP 402, que estava adormecido. O fluxo funciona assim: um agente faz uma solicitação a um recurso, o servidor responde com 402 Pagamento Necessário e um payload legível por máquina especificando o preço, ativo aceito e endereço de destino. O agente assina uma autorização de pagamento usando EIP-712 (em cadeias EVM) ou o equivalente no Solana, e então tenta novamente a solicitação com um cabeçalho X-PAYMENT. Nenhuma criação de conta, nenhum OAuth, nenhuma chave de API pré-financiada.

Para a habilidade cryptorefills-x402 especificamente, o ativo é USDC na Base e o pagamento é sem gás através de transferências assinadas por EIP-712.
 

API REST

Para desenvolvedores que desejam integração direta em vez de chamadas de ferramentas MCP, a API REST da Cryptorefills cobre todo o ciclo de vida do pedido. Navegação no catálogo via /v2/brands e /v5/products/country, precificação sob demanda via /v4/products/price, validação de pedidos via /v5/orders/validations, criação de pedidos via /v5/orders e rastreamento pós-criação via streaming ou polling.

Este é o caminho certo se você estiver construindo uma estrutura de agente personalizada, um mini app do Telegram ou um checkout embutido em uma carteira e quiser controle total sobre o fluxo de solicitações. A documentação completa dos endpoints está disponível em api-docs.
 

Passo a passo: um agente de IA comprando um cartão-presente de $50 da Amazon com USDC no Solana

Veja como é uma compra autônoma completa do início ao fim, usando o Claude Desktop com o servidor MCP da Cryptorefills instalado.

Passo 1: Adicione o servidor MCP ao Claude Desktop

Em seu claude_desktop_config.json, adicione:
 

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

O campo transport: "http" utiliza HTTP transmitível em vez de stdio, o que significa que a conexão permanece aberta durante um fluxo de compra de múltiplas etapas sem iniciar um novo processo para cada chamada de ferramenta. Nenhuma chave de API é necessária no cabeçalho para operações de catálogo e precificação.
 

Passo 2: O agente chama searchProducts

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

O servidor retorna uma lista de produtos correspondentes com seus IDs, denominações disponíveis e trilhas de pagamento suportadas.
 

Passo 3: O agente chama getProductPrice

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

Isso retorna o equivalente em USDC de $50 nas taxas atuais, juntamente com uma janela de validade da cotação. A precificação é obtida sob demanda, para que o agente nunca pague contra uma taxa desatualizada.
 

Passo 4: O agente chama validateOrder, depois createOrder

A validação ocorre primeiro para que o agente possa detectar quaisquer problemas de endereço de entrega ou disponibilidade do produto antes de se comprometer. Em caso de sucesso:
 

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

Passo 5: Resposta do pedido

{  "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": "Cartão-Presente da Amazon",    "denomination": 50,    "currency": "USD"  }}

Uma vez que o pagamento chegue ao endereço dentro da janela de expiração, o status do pedido muda para concluído e o voucher é entregue. O agente pode transmitir atualizações de status através do endpoint /track-order-stream ou recorrer ao polling.
 

Para que os agentes estão realmente usando isso

Bots de mercado de carteiras. Um usuário diz ao bot qual marca deseja. O bot cita um preço em USDC, executa e transmite o status de entrega de volta, tudo dentro da interface da carteira.

Assistentes de mini app do Telegram. Fluxos de compra conversacionais onde o agente lida com a busca de marcas, seleção de denominação e validação de pagamento, com barreiras para evitar pedidos duplicados.

Agentes de recompensas de DAO. Participação em governança on-chain, contribuições comunitárias ou conclusão de recompensas são recompensadas com vouchers de cartões-presente emitidos autonomamente de uma carteira do tesouro.

Ajudantes de gastos do tesouro. Equipes gastando de um tesouro compartilhado de stablecoin podem automatizar a aquisição controlada e auditável de cartões-presente sem etapas manuais de conversão fiat.

Para uma análise mais longa sobre a lógica de incentivo por trás dos agentes emitindo recompensas para humanos, veja Quando as IAs começam a comprar cartões-presente.
 

Por que não apenas construir sua própria camada de pagamento

A alternativa tentadora é combinar um processador de pagamento, uma API de cartões-presente e uma conversão fiat você mesmo. Na prática, isso significa gerenciar saldos pré-financiados com um provedor de terceiros, navegar por restrições geográficas na disponibilidade de cartões-presente, absorver a latência e a complexidade das trilhas fiat e manter sua própria sincronização de catálogo.

A Cryptorefills remove tudo isso. Não há necessidade de pré-financiamento, nenhuma conversão fiat no caminho crítico e o catálogo cobre mais de 6.600 marcas em mais de 180 países, disponível no momento em que seu agente chama searchProducts. A página de agentes de IA tem uma visão geral completa das habilidades disponíveis e opções de conexão.
 

Perguntas frequentes

Claude pode comprar cartões-presente?

Sim. Claude suporta MCP nativamente via Claude Desktop e Claude Code. Adicione o servidor MCP da Cryptorefills à sua configuração (veja o trecho acima) e Claude pode pesquisar o catálogo, obter um preço ao vivo, validar e criar um pedido em uma única conversa. Nenhuma chave de API ou conta separada é necessária para acesso ao catálogo e precificação.
 

O que é x402?

x402 é um padrão de pagamento HTTP aberto que reutiliza o código de status HTTP 402 para que um servidor possa declarar seu preço e método de pagamento aceito. Para agentes autônomos, isso significa fazer compras sem contas pré-registradas ou tokens OAuth. A habilidade cryptorefills-x402 implementa isso para compras totalmente autônomas.
 

Como os agentes de IA gastam dinheiro?

Um agente precisa de três coisas: uma carteira financiada (normalmente contendo stablecoins como USDC ou USDT), uma maneira de chamar serviços externos (chamadas de ferramentas MCP ou chamadas de API diretas) e um mecanismo de pagamento que não requer um humano no ponto de transação. O x402 lida com a última parte, incorporando o handshake de pagamento dentro do HTTP. Sem algo como x402 ou MCP, um agente pode preparar um pedido, mas não pode completar o pagamento por conta própria.
 

Há um servidor MCP para cartões-presente?

Sim. A Cryptorefills publica um servidor MCP que lida com ferramentas para busca de catálogo, precificação, validação de pedidos, criação de pedidos e rastreamento de entrega. Ele funciona com qualquer cliente compatível com MCP, incluindo Claude e ChatGPT.
 

Comece agora

Conecte seu agente a mais de 6.600 marcas de cartões-presente em mais de 180 países. Sem KYC. Sem pré-financiamento.

Adicione o servidor MCP diretamente no Claude Desktop, Claude Code ou qualquer tempo de execução de agente compatível com MCP.
 

npx skills add cryptorefills/agents

Abra a página de agentes de IA para ver todas as três habilidades, a configuração da habilidade x402 e a lista completa de redes de pagamento suportadas.