Creación de agentes que transaccionan con Anchor Browser y AgentCore payments

Cada vez más, los agentes de IA necesitan acceder a recursos web con precio por solicitud. Por ejemplo, los conjuntos de datos premium cobran por consulta, las APIs de investigación miden por llamada y los editores con muro de pago restringen el contenido tras un pago. Cuando un agente de IA encuentra uno de estos recursos, el servidor devuelve HTTP 402 Payment Required. El agente no tiene un mecanismo de pago integrado, ningún presupuesto asociado a la sesión ni una forma programática de satisfacer la solicitud. La tarea se detiene y requiere intervención manual.

Anchor Browser con Agentic Payments gestiona flujos de trabajo de pago de máquina a máquina en nombre del agente. Desarrollado en colaboración con el AWS Generative AI Innovation Center Partner Agent Factory, ya está disponible en AWS Marketplace. Esta publicación cubre cómo Anchor Browser se integra con Amazon Bedrock AgentCore payments para que los agentes de IA puedan pagar de forma autónoma por páginas y APIs protegidas con x402. El protocolo x402 es un estándar abierto para pagos de máquina a máquina basados en HTTP. Un servidor responde con 402 Payment Required junto con el monto, los métodos de pago aceptados y la dirección de pago que el agente utiliza para completar la transacción.

Anchor Browser es una solución de automatización de navegador basada en la nube diseñada específicamente para agentes de IA. Cada sesión de agente se ejecuta dentro de un entorno de navegador gestionado que mantiene el estado de autenticación, gestiona la navegación, captura solicitudes de red y ofrece una vista en vivo de las interacciones con la página.

Amazon Bedrock AgentCore proporciona capacidades para crear, conectar y optimizar agentes a escala. Amazon Bedrock AgentCore payments es una capacidad totalmente gestionada dentro de AgentCore que los agentes de IA pueden usar para descubrir, acceder y pagar de forma autónoma por APIs, servidores de Model Context Protocol (MCP) y contenido web. AgentCore payments gestiona la conectividad de la billetera, aplica límites de gasto configurables en la capa de infraestructura y procesa pagos mediante el protocolo x402. También proporciona observabilidad de los intentos de pago, aprobaciones, denegaciones y liquidaciones a través de Amazon CloudWatch.

Cuando un agente que se ejecuta en Anchor Browser encuentra una respuesta 402, AgentCore payments autoriza y completa la transacción dentro del presupuesto configurado. El flujo de trabajo continúa sin interrupciones.

Desafíos

Cuando un agente autónomo encuentra un recurso protegido con x402, el flujo de trabajo se detiene. El agente realiza una solicitud, como obtener un informe de investigación premium o llamar a una API de enriquecimiento de datos de pago, y el servidor responde con HTTP 402 Payment Required. Sin un mecanismo para pagar, la tarea que se suponía debía ejecutarse de forma autónoma ahora requiere intervención humana.

Hoy en día, los desarrolladores deben construir toda la pila de pago. Este esfuerzo abarca cuatro categorías de complejidad:

Gestión del protocolo de pago

• Detectar y analizar el desafío 402 de la respuesta HTTP, y distinguir las respuestas de pago requerido de otros errores 4xx.
• Construir el encabezado de pago correcto con la prueba criptográfica en el formato exacto que espera el comerciante.
• Admitir múltiples esquemas de pago (exact, upto y variantes de protocolo) sin codificar de forma rígida lógica específica del proveedor en el agente.
• Mantener la compatibilidad entre implementaciones de comerciantes x402 que pueden variar en formato de desafío, stablecoins admitidas o tiempos de liquidación.

Seguridad y gestión de claves

• Almacenar una clave privada para firmar pagos, lo que requiere un almacenamiento seguro de claves dentro de un entorno expuesto a entradas no confiables.
• Gestionar las operaciones del ciclo de vida de la billetera, incluida la rotación de claves, la actualización de credenciales y la conmutación por error del proveedor.

Resiliencia operativa

• Reenviar la solicitud original con el encabezado de pago preservando el estado de la sesión, las cookies y el contexto de la solicitud.
• Proporcionar idempotencia, que es esencial para las operaciones de billetera.
• Aplicar límites de gasto por sesión y por transacción con seguimiento presupuestario en tiempo real en ejecuciones simultáneas de agentes.

Observabilidad y cumplimiento

• Registrar cada intento de pago, aprobación, rechazo y liquidación en registros de auditoría para el cumplimiento y la conciliación.

Sin un servicio de pagos administrado, el agente debe internalizar toda la pila de pagos. En cada llamada protegida por x402 que devuelva una respuesta 402, el agente debe orquestar todo el flujo de pago internamente, incluyendo:

• Firmar la prueba.
• Adjuntar el encabezado correcto.
• Reintentar la solicitud.
• Liquidar la transacción.
• Registrar el resultado.

Cada uno de estos pasos requiere código personalizado que los desarrolladores deben construir, proteger y mantener. La Figura 1 ilustra esta arquitectura. El agente contiene ocho componentes estrechamente acoplados (Wallet, Private Keys, Budget Controls, Sign Proof, Attach Header, Retry Logic, Settle Payment y Logging). El agente se conecta a una API x402 con un desafío 402 que fluye de vuelta y un reintento que fluye hacia adelante.

Figura 1: Pila de pagos del agente

Las consideraciones de seguridad van más allá del esfuerzo de ingeniería.

Gasto sin control. Sin límites estrictos de gasto aplicados a nivel de la infraestructura, un error, un bucle de reintentos, una inyección de prompt o un acceso inadvertido puede desencadenar pagos no deseados. Un agente que reintenta un endpoint de pago en un bucle sigue autorizando pagos hasta que se produce una intervención manual.

Exposición de claves. Cuando las claves privadas residen dentro del runtime del agente, comparten un entorno de ejecución con páginas web no confiables, herramientas de terceros y dependencias externas. Estos vectores podrían divulgar inadvertidamente las credenciales que controlan fondos reales.

Exposición del flujo de firma. Si la infraestructura de firma es accesible desde el runtime, un actor de amenaza puede intentar acceder a la clave o redirigir pagos a una dirección bajo control no autorizado. Una mitigación eficaz requiere que la clave no entre en el runtime en primer lugar.

Los agentes basados en navegador introducen una restricción adicional: el pago debe realizarse dentro de la misma sesión del navegador. De lo contrario, las grabaciones de sesión y la vista en vivo dejan de coincidir con lo que realmente se ejecutó.

Solución

Anchor Browser y AgentCore payments abordan esta complejidad moviendo toda la pila de pagos a infraestructura administrada.

A diferencia de una llamada a una herramienta sin estado, Anchor Browser proporciona un navegador en la nube real con identidad persistente, flujos de trabajo repetibles y deterministas, y el contexto de sesión necesario para iniciar sesión, navegar y completar tareas de manera confiable. La autenticación, la navegación, las solicitudes de red, las grabaciones y la vista en vivo ocurren dentro de la misma sesión del navegador. Cuando se requiere un pago, la transacción ocurre dentro de esa sesión. La grabación captura la secuencia completa desde la solicitud hasta el 402, el pago y la entrega del contenido. Los agentes de Anchor incluyen una herramienta x402 integrada que maneja de forma nativa las llamadas a API de pago dentro del contexto del navegador. La herramienta integrada no requiere cambios en los flujos de trabajo existentes basados en Playwright, Puppeteer o Chrome DevTools Protocol.

AgentCore payments actúa como la capa de pagos. En el centro del servicio se encuentra el Payment Manager, el recurso de nivel superior que coordina las operaciones de pago para la cuenta de AWS. Crear un Payment Manager requiere especificar un tipo de autorizador y un rol de IAM. AgentCore entonces aprovisiona una identidad de carga de trabajo correspondiente en Amazon Bedrock AgentCore Identity.

Los componentes restantes conectan el Payment Manager con la infraestructura externa de billeteras:

• Un PaymentConnector integra el Payment Manager con un proveedor externo de billeteras, ya sea Coinbase Developer Platform (Coinbase CDP) o Stripe Privy.
• Un PaymentCredentialProvider almacena de forma segura las credenciales del proveedor de billeteras en AgentCore Identity.
• Un PaymentInstrument identifica la dirección de billetera específica de la cual se extraen los fondos.

Anchor Browser configura las billeteras a través de AgentCore payments utilizando un proveedor de billeteras compatible, sin colocar secretos de billeteras ni claves privadas dentro del runtime del agente. AgentCore payments maneja las operaciones de billeteras a través del proveedor configurado. Para el descubrimiento de endpoints, AgentCore proporciona un servidor MCP de Coinbase x402 Bazaar a través de Amazon Bedrock AgentCore Gateway, de modo que los agentes puedan descubrir programáticamente los endpoints x402 de pago por uso disponibles.

AgentCore payments reestructura la arquitectura de pagos. Las operaciones sensibles se mueven fuera del runtime del agente y hacia una capa de servicio administrado. El Anchor Agent conserva solo dos componentes relacionados con pagos: una sesión de presupuesto y la herramienta x402. La infraestructura, incluida la autenticación, los secretos de billeteras, los límites de pago, la observabilidad y la firma de pruebas de pago, reside en la capa de AgentCore payments. La Figura 2 muestra al Anchor Agent conectándose a la capa administrada de AgentCore payments, la cual maneja la integración con el proveedor de billeteras Coinbase CDP o Stripe Privy.

Figura 2: Anchor Browser se integra con AgentCore payments

Cómo funciona el flujo de pago

Los siguientes pasos describen lo que sucede de extremo a extremo, desde el momento en que una sesión del navegador se encuentra con un recurso protegido por x402 hasta el momento en que el agente recibe la respuesta y continúa la tarea.

1. Anchor Browser crea un AgentCore PaymentSession dedicado para la sesión del navegador. Cuando la sesión comienza con x402 activado, Anchor Browser aprovisiona un PaymentSession a través de AgentCore payments, vinculando la sesión del navegador a un instrumento de pago y un presupuesto configurados.
2. El navegador recibe una respuesta HTTP 402 Payment Required. El agente navega a una URL o realiza una solicitud fetch o XMLHttpRequest (XHR). El comerciante responde con un desafío 402 que especifica el importe, los métodos de pago aceptados y la dirección de pago.
3. El navegador selecciona un método de pago compatible. Anchor Browser lee la carga útil del desafío 402 y compara el método de pago solicitado con el instrumento vinculado a la PaymentSession.
4. AgentCore verifica el presupuesto de la sesión y genera la prueba criptográfica de pago. AgentCore payments valida que el importe del pago se encuentre dentro del límite de gasto de la sesión. A continuación, el servicio firma la transacción utilizando el proveedor de billetera configurado (Coinbase CDP o Stripe Privy) y devuelve la prueba criptográfica. Ningún material de claves entra en el navegador ni en el entorno de ejecución del agente.
5. El navegador reintenta la solicitud original con el encabezado de pago. El navegador adjunta la prueba firmada como PAYMENT-SIGNATURE para x402 v2 o X-PAYMENT para x402 v1, y luego reintenta la solicitud original exactamente una vez.
6. El comerciante verifica y liquida el pago, y luego devuelve el recurso protegido. El comerciante valida la prueba criptográfica, liquida la transacción en la cadena y sirve el contenido. El agente continúa con la tarea.

Las credenciales de la wallet permanecen en AgentCore y en el proveedor de wallet configurado durante todo este flujo.

Requisitos previos

Antes de comenzar, asegúrese de tener una clave de API válida de Anchor Browser (ANCHOR_API_KEY). Para crear una, consulte la guía Quick Start de Anchor Browser.

Configuración de pagos x402 automáticos

La configuración de pagos agénticos para Anchor Browser requiere una propiedad de sesión. Establezca session.x402 en true. La propiedad tiene como valor predeterminado false. Cuando está habilitada, la sesión del navegador puede acceder automáticamente a sitios web protegidos por x402 con pagos firmados por AgentCore payments y reintentados dentro de la misma sesión del navegador. Habilitar session.x402 autoriza al navegador a realizar pagos reales desde el instrumento de pago configurado.

Los siguientes ejemplos muestran cómo crear una sesión habilitada para pagos en Anchor Browser usando cURL y JavaScript:

cURL

curl --request POST
--url https://api.anchorbrowser.io/v1/sessions
--header "anchor-api-key: $ANCHOR_API_KEY"
--header "content-type: application/json"
--data '{"session":{"x402":true}}'

JavaScript

const response = await fetch('https://api.anchorbrowser.io/v1/sessions', {
  method: 'POST',
  headers: {
    'anchor-api-key': process.env.ANCHOR_API_KEY,
    'content-type': 'application/json',
  },
  body: JSON.stringify({ session: { x402: true } }),
});
const { data: session } = await response.json();
console.log(session.cdp_url);

Después de conectarse a través de Chrome DevTools Protocol, el agente navega con normalidad. No necesita incluir una clave de wallet ni un encabezado de pago en su código de automatización. El navegador gestiona de forma transparente los desafíos 402, la firma de pagos y los reintentos para la navegación de documentos y las solicitudes fetch y XHR.

Límites y comportamiento de la sesión de pago

Anchor Browser aplica las siguientes restricciones a nivel de sesión a través de la integración con AgentCore payments. Cada sesión de navegador lista para pagos opera dentro de límites de gasto y de tiempo configurados. Para conocer los límites específicos, consulte la documentación técnica de Anchor Browser.

Si la respuesta del comerciante está malformada, no se ofrece una red compatible, se agota el presupuesto o AgentCore payments rechaza el pago, el navegador devuelve a la página la respuesta 402 original sin cambios. Su código de automatización puede entonces manejar el 402 como un error HTTP estándar.

La propiedad de sesión x402 controla únicamente los pagos a recursos de terceros. La propiedad no sustituye a Anchor credits y no paga la sesión del navegador.

Código de automatización para Anchor Browser

Su código de automatización para Anchor Browser permanece sin cambios. El siguiente ejemplo demuestra que no se requiere código específico para pagos:

const { chromium } = require('playwright');
// Connect to the x402-enabled session via CDP
const browser = await chromium.connectOverCDP(session.cdp_url);
const page = await browser.newPage();
// Navigate to an x402-protected resource exactly as with a free page
await page.goto('https://premium-research.example.com/market-report');
// The page loaded, the payment was handled automatically
// Extract content as normal
const content = await page.textContent('article');

Sin lógica de wallet, sin construcción de encabezados de pago y sin código de reintento. El agente navega a la URL. Si el servidor devuelve un 402, Anchor Browser se coordina con AgentCore payments para firmar la prueba de pago, reintenta la solicitud con el encabezado de pago apropiado y entrega el contenido a la página. Su código de automatización recibe la página final renderizada sin ninguna indicación de que se haya realizado un pago.

Este patrón se aplica uniformemente al periodismo de pago, a los datos financieros con licencia, a la documentación de API restringida, a las bases de datos de investigación con medición y a otros recursos que restringen el contenido detrás de un desafío 402.

Uso de la herramienta x402 integrada para llamadas a API

Los recursos de pago no se limitan a páginas web. Muchos son API que esperan POST, PUT u otros métodos HTTP. Ejemplos comunes incluyen servicios de enriquecimiento de datos, endpoints de inferencia premium y API de contenido con licencia. Para estos casos de uso, los agentes de Anchor Browser incluyen una herramienta x402 integrada que se invoca como una API HTTPS estándar dentro del contexto del navegador.

Su agente realiza la llamada a la API a través de fetch o XHR. Si el servidor devuelve un desafío 402, el navegador coordina la firma del pago a través de AgentCore payments y reintenta la solicitud con el encabezado de pago firmado. Su código recibe la respuesta como si el endpoint fuera gratuito. La herramienta no está vinculada a un proveedor, modelo o marco específico. El pago opera como una capacidad a nivel de sesión por debajo de su tooling existente, y no se requieren cambios en el código del agente.

// Fetch call to a paid API endpoint within the x402-enabled session
const response = await page.evaluate(async () => {
  const res = await fetch('https://data-enrichment.example.com/api/v1/enrich', {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ company_domain: 'example.com' }),
  });
  return res.json();
});
// If the API returned 402, AgentCore handled payment automatically
// The response contains the enriched data
console.log(response);

Su código de automatización no recibe credenciales de wallet. Los pagos automáticos están disponibles solo cuando session.x402 está establecido en true y permanecen sujetos a los límites de gasto y de expiración descritos en la sección anterior.

Beneficios clave

Esta integración mueve el pago desde el código de la aplicación a la capa de infraestructura:

Sin infraestructura de pagos que construir. Sin SDK de wallet que integrar, sin parser de respuestas 402 que escribir, sin bucle de reintentos que implementar, sin lógica de construcción de encabezados que mantener y sin registro de auditoría personalizado que crear. AgentCore payments gestiona toda la pila de pagos.

Sin cambios en las herramientas existentes. Los scripts de Playwright, las automatizaciones de Puppeteer, los comandos de Chrome DevTools Protocol y los flujos de agentes en Anchor Browser siguen funcionando exactamente como antes. El pago es una capacidad de sesión adjunta al navegador, no una modificación de la lógica del agente, de los prompts ni de las definiciones de herramientas.

Las claves privadas no entran en el runtime. La firma y la liquidación ocurren dentro de AgentCore payments. El servicio se comunica con Coinbase CDP o Stripe Privy mediante almacenamiento seguro de credenciales en AgentCore Identity. El runtime del agente no tiene acceso al material de claves que puede mover fondos.

Los presupuestos se aplican a nivel de infraestructura. Cada sesión opera dentro de límites de gasto definidos que AgentCore aplica antes de autorizar un pago. Amazon Bedrock AgentCore Observability proporciona pistas de auditoría completas de pagos a través de Amazon CloudWatch. Cuando una sesión alcanza el límite de gasto, AgentCore payments rechaza el pago.

Las tareas de pago se completan con éxito. Las páginas GET de pago cargan. Las llamadas a API de pago devuelven respuestas. El agente completa el flujo de trabajo en lugar de detenerse en una respuesta 402 y requerir intervención manual.

La facturación se consolida. Anchor Browser liquida los cargos de terceros de x402 en créditos en la misma factura que el tiempo de sesión del navegador. No hay custodia de criptomonedas separada que gestionar, sin saldo de USDC que monitorear y sin liquidación on-chain que el equipo de finanzas tenga que conciliar.

Conclusión

Anchor Browser, integrado con AgentCore payments, dota a los agentes de IA de la capacidad de manejar de forma autónoma los desafíos de pago x402 para páginas web con muro de pago y endpoints de API de pago. Las credenciales de la wallet permanecen fuera del código del agente y no se requiere infraestructura de pagos personalizada.

A medida que una parte cada vez mayor de la web adopta precios por solicitud, los agentes que carecen de un mecanismo de pago no pueden completar tareas que involucran recursos de pago. Esta integración aborda esa brecha: los agentes completan flujos de trabajo de pago de principio a fin, operando dentro de presupuestos definidos, con observabilidad completa a través de AgentCore Observability y sin material criptográfico de claves en el runtime.

Para comenzar, explore los siguientes recursos:

• Pagos x402 automáticos en Anchor Browser
• Guía para desarrolladores de AgentCore payments
• AgentCore payments con integración de navegador
• Anchor Browser en AWS Marketplace

Sobre los autores