Como Agentes de IA Compram Cartões-Presente na Solana

Desde o lançamento do nosso recente Cryptorefills x402, agentes de IA agora podem comprar cartões-presente e recargas móveis na Solana em nosso catálogo, liquidando os pagamentos em USDC (sem a necessidade de intervenção humana em nenhum momento da transação). Este artigo explica como isso funciona na prática.

O que é x402?

x402 é um protocolo de pagamento construído sobre o código de status HTTP 402, um status que faz parte do padrão da web desde 1996, mas que nunca foi realmente utilizado para pagamentos até agora. Primeiro, um servidor informa ao cliente que o pagamento é necessário, o cliente assina uma transação e reenvia a solicitação, e o servidor entrega assim que o pagamento é confirmado. Todo o processo acontece em uma única troca, sem redirecionamento para uma página de pagamento e sem a necessidade de aprovação humana.

Na Solana, essa troca é liquidada em USDC em menos de 400ms. Rápido o suficiente para que o agente receba uma resposta confirmada na mesma etapa em que fez a compra, o que mantém a implementação simples e o fluxo ininterrupto.

Cryptorefills no x402 

A Cryptorefills construiu o lado do comerciante disso. Através da integração de Agentes de IA, qualquer agente compatível com x402 pode acessar o catálogo completo da Cryptorefills: cartões-presente de mais de 6.600 marcas, recargas móveis em 180 países e o mesmo inventário de produtos disponível para usuários regulares, tudo sem a necessidade de uma sessão de navegador ou de um humano para concluir a compra.

A configuração do pay.sh

pay.sh é um shell nativo da Solana, e a integração da Cryptorefills é enviada como um plugin para ele. A configuração leva três comandos:

Passo 1: Instalar a habilidade da Cryptorefills

Dentro de um ambiente compatível com plugins do pay.sh, a configuração consiste em três comandos:
 

/plugin marketplace add cryptorefills/agents/plugin install cryptorefills@cryptorefills-skills/plugin reload

Após o recarregamento, o agente tem acesso ao inventário completo de produtos da Cryptorefills e à lógica de pagamento subjacente para interagir com ele via x402.

Passo 2: O agente realiza a compra

Tente usar este comando:
 

"Use suas habilidades para comprar um cartão-presente de $5 da Amazon.com nos EUA usando USDC da Solana.Use o e-mail info@cryptorefills.com como beneficiário. Mostre o código do produto docartão-presente da Amazon também neste chat. Você pode encontrar a chave privada da carteirano arquivo .env sob SOLANA_SIGNER_KEY nunca exponha este valor."

O agente puxa a chave privada do arquivo .env (sob SOLANA_SIGNER_KEY), assina a transação de pagamento x402, a envia para a Solana e aguarda a confirmação. Assim que o pagamento é confirmado, a Cryptorefills entrega o código do cartão-presente, que o agente então exibe diretamente na conversa do terminal.
 

Por que Solana para isso

Velocidade e custo são as respostas óbvias, mas há mais nisso. A finalização de transações da Solana é rápida o suficiente para que o x402 possa realmente funcionar de forma síncrona em um fluxo de trabalho de agente. O agente envia o pagamento, o comerciante o confirma e a resposta retorna dentro da mesma "rodada" do ciclo de raciocínio do agente.

Compare isso com a tentativa de fazer a mesma coisa em uma cadeia mais lenta, onde os tempos de confirmação se estendem para dezenas de segundos ou minutos. Nesse ponto, você está introduzindo complexidade assíncrona, lógica de repetição e potencial para estados falhados que são realmente difíceis de lidar de forma elegante em contextos de agentes.

O USDC na Solana também contorna o problema da volatilidade. O agente está gastando um token denominado em dólar a uma taxa previsível, o que é importante quando a compra é um cartão-presente de $5 e não uma grande transferência de tesouraria.
 

O que a Cryptorefills possibilita aqui

A página de agentes de IA documenta o que está realmente disponível através da integração: cartões-presente de centenas de marcas, recargas móveis em mais de 170 países e pagamentos de contas em mercados selecionados. O catálogo é o mesmo que os usuários humanos acessam, apenas exposto através de uma API e camada de pagamento que os agentes podem realmente usar sem uma sessão de usuário.

Algumas coisas que vale a pena saber:

O inventário e a disponibilidade variam por região. Um agente que está construindo um fluxo de compra deve verificar a disponibilidade do produto dinamicamente, em vez de assumir um catálogo estático. A API cuida disso.

O e-mail do beneficiário é como a Cryptorefills roteia a entrega digital. Em fluxos automatizados, isso geralmente é um e-mail do sistema ao qual o agente tem acesso, ou um configurado no momento da configuração.

O manuseio da chave privada mostrado na demonstração (lendo do .env) é um padrão de desenvolvimento. Implantações em produção devem usar um gerenciador de segredos adequado em vez de arquivos de ambiente no disco, pois essa é a prática padrão para qualquer coisa que manipule chaves de carteira.

O catálogo completo está documentado na página de Agentes de IA da Cryptorefills. Cartões-presente de centenas de marcas nos EUA e internacionalmente, recargas móveis em mais de 180 países e pagamentos de contas em mercados selecionados. A disponibilidade varia por região, então os agentes devem verificar o que está em estoque via API no momento da compra, em vez de assumir uma lista fixa.

O cartão da Amazon de $5 no exemplo é a versão mais simples do padrão. O mesmo fluxo funciona para todos os outros itens do catálogo.
  

Para quem isso é

Desenvolvedores que estão construindo agentes que precisam gastar dinheiro em nome dos usuários ou como parte de fluxos de trabalho automatizados. Um bot de atendimento ao cliente que emite um cartão-presente como compensação. Um fluxo de trabalho que distribui recargas para usuários sem cumprimento manual. Um assistente que lida com compras em nome de um usuário. A integração Cryptorefills x402 cuida do pagamento e da entrega do produto; o desenvolvedor conecta a lógica de negócios ao redor disso.

pay.sh tem como alvo agentes que operam em ambientes de terminal, onde a interação é texto de entrada e resultado de saída. O vídeo abaixo mostra todo o fluxo, desde a instalação do plugin até o código do cartão-presente entregue no chat.