SpendTheBits Gift Cards

Un agente de IA puede comprar una tarjeta de regalo real con USDC a través de x402. Solicita una URL de tarjeta, paga una pequeña tarifa de cotización para fijar el precio exacto y luego paga el pedido a un contrato por pedido en Base. Aproximadamente cinco minutos después, la tarjeta está en la aplicación SpendTheBits de su propietario, a nombre del propietario. El propietario establece los límites, puede ser consultado primero y conserva el código a menos que decida compartirlo.

Cada tarjeta es un recurso x402

Sin llamada de catálogo ni búsqueda específica de SpendTheBits: la URL nombra la tarjeta. La tienda gratuita que la precede lista países, marcas y montos como JSON para agentes y como página para personas. Una URL pagable nunca redirige, con o sin su barra diagonal final.

https://x402.spendthebits.com/@stb/cards/                       countries (free)
https://x402.spendthebits.com/@stb/cards/usa/?q=amazon          brands + amount URLs (free)
https://x402.spendthebits.com/@stb/cards/usa/amazon-com/25/     the card: 402 = quote fee

GET  /@stb/cards/usa/amazon-com/25/           → 402  quote fee; body.card.indicative_total_usd
     PAYMENT-SIGNATURE: <signed>              → 201  { order_id, total_usdc, pay_url, status_url, claim_token }
POST <pay_url>   PAYMENT-SIGNATURE: <signed>  → 200  paid to the order's forwarder contract
GET  <status_url>   X-Claim-Token: <token>    → awaiting_payment → processing → completed

Cómo compra una tarjeta un agente

1. 1.Registra la clave del agente en la aplicación SpendTheBits y activa las tarjetas de regalo para él. Agentes → crea un agente (su clave se genera en el teléfono, nunca desde tu frase de recuperación) → Tarjetas de regalo: límite por tarjeta, límite mensual, lista de marcas opcional, Pregúntame primero. Fúndalo solo con lo que pueda gastar.
2. 2.Obtén la URL de la tarjeta. El 402 no pagado es la tarifa de cotización, y su cuerpo lleva el total indicativo de la tarjeta. Una solicitud no pagada no crea nada en el proveedor de tarjetas, por lo que navegar y consultar precios es gratuito.
3. 3.Paga la tarifa de cotización con cualquier cliente x402 estándar. La respuesta pagada es la cotización exacta: total, enlace de pago, enlace de estado, hora límite de pago y un token de reclamo.
4. 4.Paga el pedido antes de la hora límite de pago. Un pago 'exacto' de USDC en Base al contrato reenviador propio del pedido. Primero eleva el límite por pago de tu cliente por encima del total.
5. 5.Consulta el enlace de estado con el token de reclamo hasta que el pedido indique completado. Aproximadamente cinco minutos. La tarjeta aparece en los pedidos del propietario, etiquetada con el nombre del agente.

Límites, aprobaciones y códigos

Qué puede comprar un agente

Tarjetas de regalo reales de la tienda SpendTheBits: Amazon, Starbucks, Tim Hortons y cientos más, canjeables en EE. UU. y Canadá. Las tarjetas de valor fijo vienen en sus montos listados; las tarjetas variables aceptan cualquier monto entre sus límites.

Para quién es la tarjeta

Siempre para el propietario del agente, a nombre del propietario, en la aplicación del propietario. Un agente no puede poner un nombre diferente en una tarjeta; si lo intenta, se le rechaza.

Quién puede comprar

Una clave registrada en Agentes en la aplicación del propietario, con tarjetas de regalo activadas para ella. Cualquier otra clave es rechazada en la verificación, antes de que se liquide cualquier pago.

Límites del propietario

Un límite por tarjeta, un límite mensual y una lista de marcas opcional, establecidos por agente en la aplicación. La tienda también limita cada pedido de agente por tarjeta; la tienda publica el valor en vivo como max_card_usd.

Pregunta primero

Con Pregúntame primero activado (el valor predeterminado), una solicitud que supere el límite o que no esté en la lista de marcas se convierte en una pregunta en el teléfono del propietario en lugar de un rechazo. El agente lee awaiting_owner y no debe pagar; el propietario aprueba con Face ID y lo paga, o lo rechaza.

Códigos de tarjeta

Ocultos al agente por defecto. El enlace de estado nunca lleva un código. Si el propietario permite códigos para un agente, un enlace de revelación separado sirve cada código una sola vez y nunca más.

El dinero

Pagado a un contrato por pedido cuyos términos están fijos en su dirección: reenviar al proveedor de tarjetas antes de la fecha límite, pagar la tarifa de servicio cotizada o reembolsar al pagador. Pasada la fecha límite, reembolsa en su totalidad. SpendTheBits nunca lo retiene.

Precio

El precio del proveedor más una pequeña tarifa de servicio, todo en la cotización antes de pagar. El margen del proveedor es una parte mayor de una tarjeta pequeña, así que compara el total con el valor nominal.

Referidos: agrega ?ref=@handle a una URL de tarjeta. La parte del referidor de la tarifa de servicio va a un contrato de división sin propietario e inmutable, que lo paga en cadena una vez que se acumulan aproximadamente $0.50 o han pasado 24 horas, lo que ocurra primero. Regalar una tarjeta a otro @handle está construido pero no activo; la tienda rechaza un destinatario hoy.

Una compra real en mainnet, 20 de septiembre de 2026

Un cliente @x402/fetch sin modificar con una clave de agente de la pantalla Agentes del propietario compró una tarjeta de $10 de Amazon.com. Aproximadamente 4.5 minutos desde el primer pago hasta una tarjeta completada, y el agente nunca vio el código. Cada paso a continuación es una transacción pública en Base (horas UTC).

Hora	Paso	Transacción
19:04:01	Tarifa de cotización pagada (unos centavos)	0x265b368e…2254
19:04:03	Pedido pagado: 11.224455 USDC al reenviador por pedido	0x5494ea30…05de
19:04:15	Reenviador desplegado = reenviado: USDC quemado a través de Circle CCTP al proveedor de tarjetas	0xd5aecb29…1b89
~19:05	Acuñado en Ethereum a la dirección de depósito del proveedor, aproximadamente 50 s después del pago	—
19:08:28	Tarjeta emitida: completada, en la aplicación del propietario	—

El reenviador, 0x9f27…F4b1, no existía cuando el agente lo pagó. Su dirección se calculó a partir de sus términos; desplegarlo fue el reenvío. Lee el comunicado de prensa sobre la primera compra de tarjeta de regalo por un agente y cómo funcionaron los pagos de agentes de IA en producción.

Formas para que un agente de IA compre una tarjeta de regalo con stablecoins

Varios servicios venden tarjetas de regalo a agentes. Se diferencian en de quién es el dinero que gasta el agente, qué puede limitar el propietario y quién termina teniendo el código de la tarjeta. Las celdas sobre otros proveedores citan sus propias páginas.

	Cryptorefills	Bitrefill	Laso Finance	SpendTheBits
Cómo paga el agente	x402, USDC en Base o Solana	Un saldo de cuenta precargado por defecto; x402 y Lightning también se ofrecen	x402, liquidado en Base y Solana	x402, USDC en Base
De quién es el dinero y dónde está	No indicado por el proveedor	Una cuenta dedicada de saldo bajo, precargada	Una billetera que Laso mantiene para el agente, o la propia billetera del agente	La propia clave del agente, financiada por el propietario; no se mantiene saldo por ti
Límites que establece el propietario	No indicado como característica general	Precargar solo lo que una sesión pueda gastar	Un límite por pago	Un límite por tarjeta y por mes, y una lista de marcas permitidas
Una persona aprueba	Sin confirmación manual	Confirma antes de la compra por defecto	No indicado para tarjetas de regalo	Sobre un límite, se pregunta al propietario en su teléfono y aprueba con Face ID
Cuenta o identidad	Sin cuenta y sin KYC	Una cuenta	No indicado para tarjetas de regalo	La cuenta de billetera del propietario; la tarjeta se emite a nombre del propietario
Quién recibe el código de la tarjeta	No indicado por el proveedor	No indicado por el proveedor	El llamador obtiene un código de canje	La aplicación del propietario; el agente solo si el propietario lo activa
Servidor MCP	Ofrecido	Ofrecido	Ofrecido	Publicado en npm y en el Registro MCP oficial

Formas para que un agente de IA compre una tarjeta de regalo con stablecoins, según lo describe cada proveedor. Última verificación el 9 de octubre de 2026 contra las propias páginas de cada proveedor: Cryptorefills: agentes de IA, Bitrefill: MCP de comercio electrónico, Bitrefill: salvaguardas de agentes, Laso Finance, Laso Finance: referencia de agentes, SpendTheBits: servidor MCP en npm. "No indicado" significa que las páginas del proveedor no lo decían, no que la característica falte.

Ejemplos y el servidor MCP

Ejemplos ejecutables

buy-gift-card.mjs cotiza y compra una tarjeta con el cliente estándar y consulta el enlace de estado sin imprimir nunca un código; gift-card-status.mjs lee un pedido con su token de reclamo. Ambos establecen el límite por pago del cliente a propósito.

Servidor MCP

Un servidor MCP de primera parte ofrece a un asistente seis herramientas: búsqueda, precio, cotización, compra, estado del pedido y revelación de código de un solo uso. Paga con el mismo cliente x402 estándar, mantiene el token de reclamo fuera del contexto del modelo y mantiene su propio límite de gasto.

npx -y @spendthebits/mcp-giftcards

Publicado en npm y listado en el Registro MCP oficial como io.github.jkambo1986-collab/stb-giftcards. Sin una clave de agente, se inicia en modo solo lectura: búsqueda, precio y estado funcionan, y no se puede comprar nada.

Configuración del propietario, paso a paso con capturas de pantalla: cómo permitir que tu agente de IA compre una tarjeta de regalo. ¿Vender en lugar de comprar? Recibe pagos de agentes de IA.

Tarjetas de regalo para agentes: preguntas frecuentes

¿Puede un agente de IA comprar una tarjeta de regalo con USDC?

Sí. Cada tarjeta en la tienda SpendTheBits es un recurso x402 en x402.spendthebits.com/@stb/cards/<country>/<brand>/<amount>/. Un cliente x402 estándar paga una pequeña tarifa de cotización para fijar el precio exacto, luego paga el pedido en USDC en Base a un contrato por pedido. La tarjeta se emite al propietario del agente y aparece en su aplicación SpendTheBits aproximadamente cinco minutos después.

¿El agente ve el código de la tarjeta de regalo?

No por defecto. El enlace de estado nunca incluye un código. Un propietario puede permitir códigos para un agente; entonces un enlace de revelación separado sirve cada código exactamente una vez.

¿Qué sucede cuando el agente solicita una tarjeta por encima del límite del propietario?

Con Pregúntame primero activado, el propietario recibe una notificación que nombra al agente, la marca, el monto y el total, y aprueba o rechaza con un toque. El estado del agente lee awaiting_owner y no debe pagar. Con Pregúntame primero desactivado, la solicitud se rechaza antes de que se cobre algo.

¿Por qué mi cliente x402 se niega a pagar la tarjeta?

Los clientes estándar limitan cada pago a aproximadamente un dólar por defecto. Eleva el límite por encima del total de la tarjeta, por ejemplo spendControls.maxAmountPerPayment en @x402/fetch. El cuerpo 402 de la URL de la tarjeta lleva un spend_controls_hint con el número a usar.

¿Quién retiene el dinero mientras se emite la tarjeta?

Nadie. El pedido se paga a un contrato reenviador por pedido sin propietario. Solo puede reenviar el USDC al proveedor de tarjetas antes de la fecha límite, pagar la tarifa de servicio cotizada o reembolsar al pagador.

¿Hay un servidor MCP para tarjetas de regalo?

Sí. El servidor de primera parte está en npm como @spendthebits/mcp-giftcards y en el Registro MCP oficial como io.github.jkambo1986-collab/stb-giftcards. Ofrece a un asistente seis herramientas: búsqueda, precio, cotización, compra, estado del pedido y revelación de código de un solo uso. Ejecútalo con npx -y @spendthebits/mcp-giftcards. Cualquier cliente x402 estándar también funciona, y hay ejemplos ejecutables en GitHub.