

La mayoría de las integraciones de API asumen que hay un humano en el proceso. Están diseñadas en torno a cuentas, flujos de OAuth, claves preemitidas y interfaces de pago, porque hasta hace poco, el software que necesitaba comprar algo no tenía una forma clara de hacerlo por sí mismo.
Eso está cambiando. Lo que la gente llama comercio agente es el patrón donde el software autónomo puede descubrir, fijar precios y comprar bienes sin esperar a que un humano confirme cada paso. Es un modelo diferente de la integración de API tradicional en un aspecto fundamental: el agente no se registra previamente, no mantiene un token de sesión y no redirige a nadie a una pantalla de pago.
Las tarjetas de regalo encajan naturalmente aquí. Son digitales, se pueden emitir al instante y no requieren envío ni verificación de identidad por parte del comprador. Este artículo cubre cómo funciona la infraestructura y cómo configurarla.
Habilidades, MCP y x402 dan a los agentes las herramientas para cotizar, validar y comprar tarjetas de regalo, eSIMs y recargas de forma autónoma, con stablecoins.Conecta tu agente de IA a más de 6600 productos en más de 180 países.
Sin KYC. Sin tarjetas de crédito.
MCP es la capa que permite a un modelo de IA llamar a herramientas externas. En lugar de que tu código acceda directamente a una API, el agente llama a una herramienta nombrada, el servidor MCP traduce eso en la solicitud correcta y el resultado regresa en un formato que el modelo puede razonar. Para las compras de tarjetas de regalo, esto significa que el agente puede llamar a searchProducts, getProductPrice, validateOrder y createOrder como llamadas de herramienta naturales en lugar de llamadas HTTP en bruto.
El servidor MCP de Cryptorefills está publicado en api.cryptorefills.com/mcp y es autodescubierto a través del manifiesto /.well-known/mcp.json, por lo que los clientes compatibles con MCP, incluidos Claude y ChatGPT, pueden conectarse sin ningún código adicional. Consulta la guía de integración de MCP para conocer la historia de su construcción.
x402 es un estándar de pago abierto que reactiva el código de estado HTTP 402, que había estado inactivo durante mucho tiempo. El flujo funciona así: un agente hace una solicitud a un recurso, el servidor responde con 402 Payment Required y una carga útil legible por máquina que especifica el precio, el activo aceptado y la dirección de destino. El agente firma una autorización de pago utilizando EIP-712 (en cadenas EVM) o el equivalente en Solana, y luego vuelve a intentar la solicitud con un encabezado X-PAYMENT. No se requiere creación de cuenta, no hay OAuth, ni clave API prefinanciada.
Para la habilidad cryptorefills-x402 específicamente, el activo es USDC en Base y el pago es sin gas a través de transferencias firmadas por EIP-712.
Para los desarrolladores que desean una integración directa en lugar de llamadas de herramientas MCP, la API REST de Cryptorefills cubre todo el ciclo de vida del pedido. Navegación del catálogo a través de /v2/brands y /v5/products/country, fijación de precios justo a tiempo a través de /v4/products/price, validación de pedidos a través de /v5/orders/validations, creación de pedidos a través de /v5/orders y seguimiento posterior a la creación a través de streaming o polling.
Este es el camino correcto si estás construyendo un marco de agente personalizado, una mini aplicación de Telegram o un proceso de pago integrado en una billetera y deseas tener control total sobre el flujo de solicitudes. La documentación completa de los puntos finales está disponible en api-docs.
Así es como se ve una compra autónoma completa de principio a fin, utilizando Claude Desktop con el servidor MCP de Cryptorefills instalado.
En tu claude_desktop_config.json, agrega:
{ "mcpServers": { "cryptorefills": { "url": "https://api.cryptorefills.com/mcp/http", "transport": "http", "headers": { "User-Agent": "Cryptorefills-MCP/1.0" } } }}
El campo transport: "http" utiliza HTTP transmitible en lugar de stdio, lo que significa que la conexión permanece abierta a lo largo de un flujo de compra de múltiples pasos sin generar un nuevo proceso para cada llamada de herramienta. No se requiere clave API en el encabezado para operaciones de catálogo y precios.
{ "tool": "searchProducts", "input": { "query": "Amazon", "country": "US", "category": "gift_cards" }}
El servidor devuelve una lista de productos coincidentes con sus IDs, denominaciones disponibles y vías de pago soportadas.
{ "tool": "getProductPrice", "input": { "product_id": "amazon-us-50", "currency": "USDC", "network": "solana" }}
Esto devuelve el equivalente en USDC de $50 a las tasas actuales, junto con una ventana de validez de la cotización. El precio se obtiene justo a tiempo, por lo que el agente nunca paga contra una tasa obsoleta.
La validación se ejecuta primero para que el agente pueda detectar cualquier problema con la dirección de entrega o la disponibilidad del producto antes de comprometerse. Si tiene éxito:
{ "tool": "createOrder", "input": { "product_id": "amazon-us-50", "currency": "USDC", "network": "solana", "delivery_email": "user@example.com" }}
{ "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": "Tarjeta de Regalo de Amazon", "denomination": 50, "currency": "USD" }}
Una vez que el pago llegue a la dirección dentro de la ventana de caducidad, el estado del pedido pasa a completado y el voucher es entregado. El agente puede transmitir actualizaciones de estado a través del punto final /track-order-stream o recurrir al polling.
Bots de mercado de billeteras. Un usuario le dice al bot qué marca desea. El bot cotiza un precio en USDC, ejecuta y transmite el estado de entrega, todo dentro de la interfaz de la billetera.
Asistentes de mini aplicaciones de Telegram. Flujos de compra conversacionales donde el agente maneja la búsqueda de marcas, la selección de denominaciones y la validación de pagos, con medidas de seguridad para prevenir pedidos duplicados.
Agentes de recompensas DAO. La participación en la gobernanza en cadena, las contribuciones a la comunidad o la finalización de recompensas se recompensan con vouchers de tarjetas de regalo emitidos de forma autónoma desde una billetera del tesoro.
Ayudantes de gasto del tesoro. Los equipos que gastan desde un tesoro compartido de stablecoins pueden automatizar la adquisición controlada y auditable de tarjetas de regalo sin pasos manuales de conversión a fiat.
Para una mirada más profunda a la lógica de incentivos detrás de los agentes que emiten recompensas a humanos, consulta Cuando las IA comienzan a comprar tarjetas de regalo.
La alternativa tentadora es combinar un procesador de pagos, una API de tarjetas de regalo y una conversión a fiat tú mismo. En la práctica, eso significa gestionar saldos prefinanciados con un proveedor externo, navegar por las restricciones geográficas sobre la disponibilidad de tarjetas de regalo, absorber la latencia y complejidad de las vías fiat, y mantener la sincronización de tu propio catálogo.
Cryptorefills elimina todo eso. No se requiere prefinanciación, no hay conversión a fiat en la ruta crítica y el catálogo cubre más de 6,600 marcas en más de 180 países, disponibles en el momento en que tu agente llama a searchProducts. La página de agentes de IA tiene una visión general completa de las habilidades y opciones de conexión disponibles.
Sí. Claude admite MCP de forma nativa a través de Claude Desktop y Claude Code. Agrega el servidor MCP de Cryptorefills a tu configuración (consulta el fragmento anterior) y Claude puede buscar en el catálogo, obtener un precio en vivo, validar y crear un pedido en una sola conversación. No se requiere una clave API o cuenta separada para acceder al catálogo y precios.
x402 es un estándar de pago HTTP abierto que reutiliza el código de estado HTTP 402 para que un servidor pueda declarar su precio y método de pago aceptado. Para los agentes autónomos, esto significa realizar compras sin cuentas pre-registradas o tokens de OAuth. La habilidad cryptorefills-x402 implementa esto para compras completamente autónomas.
Un agente necesita tres cosas: una billetera financiada (que típicamente contiene stablecoins como USDC o USDT), una forma de llamar a servicios externos (llamadas de herramientas MCP o llamadas API directas) y un mecanismo de pago que no requiera un humano en el momento de la transacción. x402 maneja la última parte al incrustar el apretón de manos de pago dentro de HTTP. Sin algo como x402 o MCP, un agente puede preparar un pedido, pero no puede completar el pago por su cuenta.
Sí. Cryptorefills publica un servidor MCP que maneja herramientas para búsqueda de catálogo, fijación de precios, validación de pedidos, creación de pedidos y seguimiento de entregas. Funciona con cualquier cliente compatible con MCP, incluidos Claude y ChatGPT.
Conecta tu agente a más de 6,600 marcas de tarjetas de regalo en más de 180 países. Sin KYC. Sin prefinanciación.
Agrega el servidor MCP directamente en Claude Desktop, Claude Code o cualquier entorno de ejecución compatible con MCP.
npx skills add cryptorefills/agents
Abre la página de agentes de IA para ver las tres habilidades, la configuración de la habilidad x402 y la lista completa de redes de pago soportadas.