Cómo los agentes de IA compran tarjetas de regalo en Solana

Desde el lanzamiento de nuestro reciente Cryptorefills x402, los agentes de IA ahora pueden comprar tarjetas de regalo y recargas móviles en Solana en nuestro catálogo, liquidando los pagos en USDC (sin intervención humana en ningún momento de la transacción). Este artículo explica cómo funciona esto en la práctica.

¿Qué es x402?

x402 es un protocolo de pago construido sobre el código de estado HTTP 402, un estado que ha estado en el estándar web desde 1996, pero que nunca se utilizó realmente para pagos hasta ahora. Primero, un servidor informa al cliente que se requiere un pago, el cliente firma una transacción y reenvía la solicitud, y el servidor entrega una vez que se confirma el pago. Todo ocurre en un solo intercambio, sin redirección a una página de pago y sin necesidad de que un humano apruebe nada.

En Solana, ese intercambio se liquida en USDC en menos de 400 ms. Lo suficientemente rápido como para que el agente reciba una respuesta confirmada dentro del mismo paso en que realizó la compra, lo que mantiene la implementación simple y el flujo ininterrumpido.

Cryptorefills en x402 

Cryptorefills construyó el lado del comerciante de esto. A través de la integración de Agentes de IA, cualquier agente compatible con x402 puede acceder al catálogo completo de Cryptorefills: tarjetas de regalo de más de 6,600 marcas, recargas móviles en 180 países y el mismo inventario de productos disponible para usuarios regulares, todo sin necesidad de una sesión de navegador o un humano para completar la compra.

La configuración de pay.sh

pay.sh es un shell nativo de Solana para agentes, y la integración de Cryptorefills se envía como un complemento para ello. Configurarse lleva tres comandos:

Paso 1: Instalar la habilidad de Cryptorefills

Dentro de un entorno compatible con complementos de pay.sh, la configuración consiste en tres comandos:
 

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

Después de recargar, el agente tiene acceso al inventario completo de productos de Cryptorefills y la lógica de pago subyacente para interactuar con él a través de x402.

Paso 2: El agente realiza la compra

Intenta usar este aviso:
 

"Usa tus habilidades para comprar una tarjeta de regalo de $5 de Amazon.com en EE. UU. usando Solana USDC.Usa el correo electrónico info@cryptorefills.com como beneficiario. Muestra el código del producto de latarjeta de regalo de Amazon también en este chat. Puedes encontrar la clave privada para la billeteraen el archivo .env bajo SOLANA_SIGNER_KEY nunca expongas este valor."

El agente extrae la clave privada del archivo .env (bajo SOLANA_SIGNER_KEY), firma la transacción de pago x402, la envía a Solana y espera la confirmación. Una vez que el pago se procesa, Cryptorefills entrega el código de la tarjeta de regalo que el agente luego presenta directamente en la conversación del terminal.
 

¿Por qué Solana para esto?

La velocidad y el costo son las respuestas obvias, pero hay más. La finalización de transacciones de Solana es lo suficientemente rápida como para que x402 pueda funcionar realmente de manera sincrónica en un flujo de trabajo de agente. El agente envía el pago, el comerciante lo confirma y la respuesta regresa dentro del mismo "turno" del ciclo de razonamiento del agente.

Compara eso con intentar lo mismo en una cadena más lenta donde los tiempos de confirmación se extienden a decenas de segundos o minutos. En ese punto, introduces complejidad asíncrona, lógica de reintentos y potenciales estados fallidos que son realmente difíciles de manejar con gracia en contextos de agentes.

USDC en Solana también evita el problema de la volatilidad. El agente está gastando un token denominado en dólares a una tasa predecible, lo cual es importante cuando la compra es una tarjeta de regalo de $5 y no una gran transferencia de tesorería.
 

Lo que Cryptorefills habilita aquí

La página de agentes de IA documenta lo que realmente está disponible a través de la integración: tarjetas de regalo de cientos de marcas, recargas móviles en más de 170 países y pagos de facturas en mercados selectos. El catálogo es el mismo al que acceden los usuarios humanos, solo que expuesto a través de una API y una capa de pago que los agentes pueden usar sin una sesión de usuario.

Algunas cosas que vale la pena saber:

El inventario y la disponibilidad varían según la región. Un agente que construye un flujo de compra debe verificar la disponibilidad del producto de manera dinámica en lugar de asumir un catálogo estático. La API maneja esto.

El correo electrónico del beneficiario es cómo Cryptorefills dirige la entrega digital. En flujos automatizados, este suele ser un correo electrónico del sistema al que el agente tiene acceso, o uno configurado en el momento de la configuración.

El manejo de la clave privada mostrado en la demostración (leyendo desde .env) es un patrón de desarrollo. Las implementaciones en producción deben usar un administrador de secretos adecuado en lugar de archivos de entorno en disco porque esa es la práctica estándar para cualquier cosa que maneje claves de billetera.

El catálogo completo está documentado en la página de Agentes de IA de Cryptorefills. Tarjetas de regalo de cientos de marcas en EE. UU. e internacionalmente, recargas móviles en más de 180 países y pagos de facturas en mercados selectos. La disponibilidad varía según la región, por lo que los agentes deben verificar qué hay en stock a través de la API en el momento de la compra en lugar de asumir una lista fija.

La tarjeta de $5 de Amazon en el ejemplo es la versión más simple del patrón. El mismo flujo funciona para todo lo demás en el catálogo.
  

¿Para quién es esto?

Desarrolladores que construyen agentes que necesitan gastar dinero en nombre de los usuarios o como parte de flujos de trabajo automatizados. Un bot de servicio al cliente que emite una tarjeta de regalo como compensación. Un flujo de trabajo que distribuye recargas a los usuarios sin cumplimiento manual. Un asistente que maneja compras en nombre de un usuario. La integración de Cryptorefills x402 maneja el pago y la entrega del producto; el desarrollador conecta la lógica empresarial a su alrededor.

pay.sh está dirigido a agentes que se ejecutan en entornos de terminal, donde la interacción es texto de entrada, resultado de salida. El video a continuación muestra el flujo completo, desde la instalación del complemento hasta el código de la tarjeta de regalo entregado en el chat.