Checkout agéntico

El checkout agéntico completa la transacción: coordina el estado, los tokens limitados, la autorización humana, los webhooks y la cuestión abierta de los contracargos.

Publicado por primera vez: 3 jul 2026 · Última actualización: 8 ago 2026 · Avanzado
Idiomas

El checkout agéntico permite que un agente de IA cree, actualice y finalice una compra. Es un bloque de ACP y UCP, no un protocolo independiente. Funciona como una máquina de estados, usa tokens limitados por comercio, importe, tiempo y uso, y confirma el pedido mediante webhooks HMAC de objeto completo. El comercio conserva la responsabilidad de registro y contracargos, aunque la evidencia para disputar una compra mediada por IA sigue sin resolverse.

TL;DR — El checkout agéntico completa una transacción: crea, actualiza, completa o cancela una sesión, delega el pago y confirma el pedido. Es un bloque de ACP y UCP, no un protocolo independiente. Su columna vertebral es una máquina de estados y puede detenerse para una escalación o autenticación. Los tokens están limitados por comercio, importe, tiempo y uso único; el agente nunca conserva una tarjeta. La confirmación llega mediante webhooks HMAC con el objeto completo. El comercio conserva la responsabilidad de registro y contracargos, aunque el marco probatorio sigue abierto. La integración reconoce not_ready_for_payment, ready_for_payment, requires_escalation, authentication_required, completed, incomplete, ready_for_complete.

Evidence for this claim OpenAI's commerce specification models checkout as a stateful API flow with explicit completion and escalation states. Scope: OpenAI commerce implementation; other agentic checkout systems may use different state names. Confidence: high · Verified: OpenAI Commerce: Checkout specification Evidence for this claim OpenAI's delegated-payment specification uses scoped payment tokens and keeps the merchant as merchant of record. Scope: OpenAI delegated-payment flow, not a guarantee that every agentic checkout implementation handles payment identically. Confidence: high · Verified: OpenAI Commerce: Payment specification

Alcance: es el paso de transacción, no todo el protocolo

El checkout agéntico es una capacidad. En ACP aparece como el bloque Agentic Checkout, junto a Product Feed, Delegate Payment, Delegate Authentication y Orders/Webhooks. En UCP es una capacidad dentro de una especificación más amplia. Aquí interesan ciclo de vida, pago delegado, intervención, confirmación y responsabilidad. El ejemplo utiliza /.well-known/ucp.

Los agentes operan contra feeds y API, no contra el HTML rastreado. Por eso aquí se optimiza la fiabilidad del checkout, no el texto de la página.

La máquina de estados de la sesión de checkout

La diferencia que muchas explicaciones omiten es que un checkout es una sesión con estado. Ese estado avanza por una máquina definida y cada transición debe ser visible.

La referencia de Checkout de ACP enumera los estados y distingue un camino feliz corto de las ramas terminales. La opción de fulfillment lleva la sesión hacia el pago; si falla, puede volver a estar lista para reintentarlo. La receta comprueba incomplete, not_ready_for_payment, requires_escalation, authentication_required, ready_for_payment, pending_approval, complete_in_progress, completed, canceled, in_progress, expired.

Esta revisión técnica aborda el checkout agéntico aquí: Los estados explican espera, fallo y finalización.

  • Escalación o autenticación requerida: el agente necesita una persona o una comprobación.\n- Aprobación pendiente: espera una autorización B2B.\n- Expirada: la sesión superó su plazo. El seguimiento registra requires_escalation, authentication_required, pending_approval, expired, CheckoutSession, expires_at.

El checkout de UCP aplica el mismo diseño: una sesión incompleta puede pedir una escalación y volver a la finalización mediante una URL de continuación. Dos protocolos convergen en que no siempre se puede terminar sin preguntar a una persona. La entrega incluye incomplete, requires_escalation, ready_for_complete, continue_url.

Escalation is a first-class checkout state: the agent pauses, a human completes the required step, and the same session resumes. Fuente: Agentic Commerce Protocol

The happy path assembles the cart and fulfillment choice, becomes ready for payment, processes a scoped payment token, and completes. When a step-up is needed, the session enters requires escalation or authentication. A human completes login, 3-D Secure, or approval, then the session resumes at payment processing.

© Patrick Stox LLC · CC BY 4.0 ·

Una solicitud mal formada devuelve un error HTTP, mientras que un problema comercial dentro de una sesión válida llega como MessageError en messages[]. La integración debe tratar ambos caminos. La verificación reúne type, invalid_request, request_not_idempotent, processing_error, service_unavailable, MessageError, messages[].

Cómo funciona la delegación del pago

La delegación existe para que los datos brutos de la tarjeta nunca lleguen al agente. Los datos de pago se convierten en un token con alcance limitado.

Según OpenAI, el payload va al PSP o a la bóveda del comercio, que devuelve un token acotado fuera del alcance de PCI. Ese sistema lo limita en cuatro dimensiones.

  • Motivo: uso único.\n- Importe máximo: impide cobrar más que el total.\n- Vencimiento: fija la fecha límite.\n- Comercio y sesión: vincula el token con ambos. La ficha conserva reason, "one_time", max_amount, expires_at, merchant_id, checkout_session_id.

El token está bloqueado al comercio, limitado por importe y tiempo, y destinado a un único uso. Así el agente compra sin recibir una credencial reutilizable. Stripe describe Shared Payment Token como una implementación compatible; UCP separa instrumentos y handlers.

El alcance de PCI es una decisión real. Una integración directa puede manejar datos del titular y exigir PCI DSS de nivel 1. Para la mayoría, el camino tokenizado deja los datos en el PSP. Elegir entre manejar CHD o dejar que el PSP tokenice es la decisión inicial.

Cuándo todavía debe intervenir una persona

Decir que «el comprador todavía lo autoriza» es impreciso. Los activadores son concretos; nombrarlos permite diseñar la transferencia de control en vez de llegar a un callejón sin salida.

  • 3-D Secure y step-up: ACP modela capacidades, niveles y contextos; el resultado puede ser autenticado, denegado, rechazado, abandonado, cancelado o no compatible.\n- Escalación: indica que falta una persona o comprobación.\n- Aprobación B2B: los datos pueden incluir orden de compra y condiciones.\n- UCP: una URL de continuación permite terminar el inicio de sesión o la confirmación. La referencia mantiene InterventionCapabilities, 3ds, address_verification, enforcement, always, conditional, optional, display_context, native, webview, modal, redirect, AuthenticationResult, authenticated, denied, rejected, abandoned, canceled, not_supported, requires_escalation, authentication_required, approval_required, PaymentData, purchase_order_number, payment_terms, due_date, continue_url.

Una transacción que escala de forma limpia es mejor que una que termina silenciosamente. Las rutas de escalación deben diseñarse como flujos principales.

La confirmación del pedido es un envío, no una consulta

Después de una compra, la plataforma no tiene que consultar continuamente la API. El comercio envía webhooks firmados y la superficie del agente recibe la verdad del pedido.

La referencia de ACP define eventos de pedido para mantener sincronizado el fulfillment. Hay eventos de creación y actualización; importan la firma, el objeto completo y la respuesta. La validación comprueba order_create, order_update, created, manual_review, confirmed, canceled, shipped, fulfilled.

  • Firma: la cabecera HMAC debe validarse.\n- Objeto completo: data contiene el objeto Order entero.\n- Respuestas: trata éxito, firma inválida y limitación. La descripción retiene Merchant-Signature, 401, data, 200, 429.

La plataforma sabe que el pedido salió adelante porque el comercio lo comunica con un POST firmado que contiene el objeto completo y respeta los reintentos. El inventario enumera 429.

Fraude, contracargos y responsabilidad: qué está resuelto y qué no

Esta revisión técnica aborda el checkout agéntico aquí: El reintento evita pérdida y duplicación.

Resuelto: el comercio de registro. La especificación de OpenAI indica que OpenAI no es el comercio de registro. El comercio aporta su PSP y conserva liquidación, reembolsos, contracargos y cumplimiento.

Abierto: la prueba de un contracargo. Saber quién absorbe una disputa no explica cómo ganarla cuando el comprador fue mediado por IA. Los registros del agente son otra clase de evidencia y las reglas de las redes no se escribieron para ellos.

Los marcos emergentes no están terminados. Visa presenta Trusted Agent Protocol para verificar identidad e intención. Mastercard Agent Pay y Agentic Tokens forman otra línea. La atribución de terceros debe tratarse como reportada, no confirmada.

Qué deben implementar y probar los comercios

El contenido existente aconseja feeds limpios y programas de fidelidad. La capa operativa añade qué construir y verificar antes de activar el checkout agéntico.

  • Postura de PCI: compara tokens del PSP con el manejo directo de CHD.\n- Reintentos: una clave repetida no debe duplicar cargos.\n- Webhooks: valida HMAC.\n- Escalaciones: fuerza autenticación y 3DS.\n- Precios: feed y checkout deben coincidir.\n- Atribución: registra el origen en OMS. La arquitectura considera request_not_idempotent, Merchant-Signature, 200, 429, requires_escalation, authentication_required, AuthenticationResult, denied, rejected, abandoned, authenticated.

Esta revisión técnica aborda el checkout agéntico aquí: Una integración fiable registra contexto antes de operar.

Situación a mediados de 2026

La adopción real era temprana. Solo una fracción pequeña de comercios de Shopify usaba checkout con IA y OpenAI había devuelto Instant Checkout hacia descubrimiento y redirección por problemas de incorporación, precisión y carritos con varios artículos.

Eso no convierte el checkout agéntico en humo. Crear, actualizar y completar una sesión con pago delegado y webhooks firmados está especificado; lo que cambia es si termina en el chat o en el sitio.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.