Este tutorial es una guía paso a paso para integrar el Agentic Commerce Protocol (ACP) en tu e-commerce, permitiéndote abrir un nuevo canal de ventas conversacional a través de ChatGPT. Aquí aprenderás desde la preparación y entrega de tu feed de productos, pasando por la implementación de la API de checkout, la configuración de webhooks y la integración de pagos delegados, hasta realizar las pruebas y certificación final.
El Agentic Commerce Protocol (ACP) es un nuevo estándar abierto desarrollado por OpenAI, en colaboración con Stripe, que permite a los agentes de inteligencia artificial (como ChatGPT) interactuar y coordinar compras de forma segura y eficiente. Con ACP, tu negocio se mantiene como el vendedor oficial (merchant of record), y tú gestionas el pago, el envío, las devoluciones y la relación con el cliente, sin tener que reconstruir tu infraestructura e-commerce.
Ventajas clave: - Integración Conversacional: Abre un canal de ventas directamente en plataformas de chat (como ChatGPT). - Control Total del Merchant: Conservas la propiedad de la relación con el cliente y todos los procesos post-venta. - Compatibilidad con Infraestructuras Existentes: No es necesario rehacer tu sistema; ACP se integra con tus APIs actuales. - Seguridad y Buenas Prácticas: Uso de autenticación, idempotencia, validación robusta y cifrado en cada etapa del proceso.
En este tutorial detallo cada paso requerido para implementar ACP: 1. Product Feed: Cómo preparar y entregar un archivo estructurado con tu catálogo actualizado. 2. API de Checkout: Creación y actualización de sesiones de checkout a través de endpoints REST. 3. Webhooks: Configuración para mantener sincronizados los estados de las órdenes con ChatGPT. 4. Pagos Delegados: Integración segura de pagos mediante tokens (inicialmente vía Stripe). 5. Pruebas y Certificación: Requisitos y pasos finales para asegurar que la integración cumpla con las especificaciones de OpenAI.
El primer paso es generar un feed de productos estructurado que contenga toda la información necesaria del catálogo. Este archivo permite a ChatGPT descubrir y recomendar productos de forma precisa.
id (SKU único)title (nombre del producto)descriptionproduct_category y brandlink (URL del producto)image_link (imagen principal)price (formateado con moneda, por ejemplo: "79.99 USD")availability (in_stock, out_of_stock, preorder)inventory_quantityseller_privacy_policy y seller_tos para generar confianza en el canal conversacional.enable_search y enable_checkout para controlar aparición del producto en búsquedas y su elegibilidad para Instant Checkout.shipping (ejemplo: "US:CA:Estandar:5.00 USD")delivery_estimate[
{
"id": "SKU12345",
"title": "Zapatillas de trail running - Hombre - Negro",
"description": "Calzado impermeable con suela amortiguada para senderismo y actividades outdoor.",
"link": "https://tu-tienda.com/producto/SKU12345",
"image_link": "https://tu-tienda.com/img/SKU12345_1.jpg",
"brand": "TuMarca",
"product_category": "Deportes > Calzado > Trail Running",
"price": "79.99 USD",
"availability": "in_stock",
"inventory_quantity": 25,
"enable_search": "true",
"enable_checkout": "true",
"seller_name": "Tu Tienda Online",
"seller_url": "https://tu-tienda.com/",
"seller_privacy_policy": "https://tu-tienda.com/privacidad",
"seller_tos": "https://tu-tienda.com/terminos",
"shipping": "US:CA:Estandar:5.00 USD",
"delivery_estimate": "2025-08-12"
}
]
POST a un endpoint seguro proporcionado por OpenAI o mediante SFTP.Para gestionar el proceso de checkout vía ChatGPT, debes implementar una serie de endpoints REST que permitan:
Endpoint: POST /checkout_sessions
Ejemplo de respuesta JSON:
json
{
"id": "checkout_session_123",
"payment_provider": {
"provider": "stripe",
"supported_payment_methods": ["card"]
},
"status": "not_ready_for_payment",
"currency": "usd",
"line_items": [
{
"id": "line_item_1",
"item": { "id": "SKU12345", "quantity": 1 },
"base_amount": 7999,
"discount": 0,
"subtotal": 7999,
"tax": 800,
"total": 8799
}
],
"fulfillment_options": [
{
"id": "ship_opt_1",
"label": "Envío estándar (5-7 días)",
"amount": 500,
"estimated_days": 7
},
{
"id": "ship_opt_2",
"label": "Envío express (2-3 días)",
"amount": 1500,
"estimated_days": 3
}
],
"fulfillment_option_id": null,
"totals": [
{ "type": "subtotal", "amount": 7999 },
{ "type": "tax", "amount": 800 },
{ "type": "shipping", "amount": 0 },
{ "type": "total", "amount": 8799 }
],
"messages": [
{ "type": "info", "text": "Agregá una dirección para calcular el envío." }
],
"links": [
{ "rel": "privacy_policy", "href": "https://tu-tienda.com/privacidad" },
{ "rel": "terms_of_service", "href": "https://tu-tienda.com/terminos" }
]
}
Endpoint: POST /checkout_sessions/{session_id}
Idempotency-Key.Endpoint: POST /checkout_sessions/{session_id}/complete
status: "completed") e identificación de la orden.Endpoint: POST /checkout_sessions/{session_id}/cancel
"canceled" y mensajes opcionales.Endpoint: GET /checkout_sessions/{session_id}
Para mantener a ChatGPT informado del estado de la orden, implementa webhooks que notifiquen eventos clave. Los eventos comunes incluyen:
order.createdorder.paidorder.fulfilledorder.canceled{
"event": "order.fulfilled",
"order_id": "ORD-1001",
"tracking_url": "https://correo.com/track/XYZ123",
"status": "shipped",
"estimated_delivery_date": "2025-11-15"
}
Buenas Prácticas: - Autenticación en cada webhook (verificación de firma, HTTPS). - Uso de idempotencia para evitar duplicados en caso de reintentos.
El componente final es el pago delegado, que asegura el manejo seguro de datos sensibles mediante tokens.
vt_XXXXXXXXXXXXXXXX)./checkout_sessions/{session_id}/complete, se recibe el token y se procesa el pago utilizando la API de Stripe (o el PSP que utilices).Recomendación:
Si ya usas Stripe, la integración de pagos delegados se realiza con mínimas modificaciones en tu código. Consulta la documentación actualizada de Stripe para ver el snippet en el lenguaje de tu preferencia.
Ambiente de Pruebas (Sandbox):
Realiza pruebas simulando solicitudes reales de ChatGPT para verificar que todos los endpoints funcionen correctamente (creación, actualización, cancelación, consulta de checkout y procesamiento de pagos).
Validación de Esquemas JSON:
Utiliza los esquemas de OpenAI para validar que tus respuestas cumplan con la especificación (estructuras, formatos de fecha y moneda, códigos de estado HTTP, etc.).
Revisión de Seguridad:
Asegúrate de que todas las llamadas estén protegidas con HTTPS, verifiquen firmas, y usen autenticación mediante API Keys.
Certificación con OpenAI:
Coordina una sesión de certificación con el equipo de OpenAI. Ellos comprobarán que tu integración cumple todos los requisitos y te otorgarán acceso a producción.
Lanzamiento Gradual:
Considera lanzar la funcionalidad de Instant Checkout inicialmente en mercados donde esté disponible (EE.UU., por ejemplo) e ir extendiéndolo geográficamente.
Integrar el Agentic Commerce Protocol en tu e-commerce te abre un nuevo canal de ventas conversacional que aprovecha la inteligencia artificial para ofrecer una experiencia de compra fluida y moderna. Con este tutorial, has aprendido a: - Preparar y mantener un feed de productos actualizado. - Implementar endpoints para la creación, actualización y completado del checkout. - Configurar webhooks para sincronizar el estado de las órdenes. - Integrar pagos delegados de forma segura utilizando tokens. - Realizar pruebas y certificar la integración según los estándares de OpenAI.
Si deseas obtener asistencia experta en la integración de ACP, Agentify AI está a tu disposición para ayudarte a transformar tu e-commerce y aprovechar al máximo este innovador canal de ventas.
¿Listo para comenzar la integración?
Contáctanos para una consultoría personalizada y sigue nuestras actualizaciones en Instagram @agentify.uy.
Última actualización: Octubre 2025.
Referencias y enlaces de documentación: - VentureBeat - ACP y ChatGPT Buy Button - Eesel.ai - Guía sobre OpenAI Agentic Commerce Protocol - Documentación de OpenAI Developers - Registro de Comerciantes ChatGPT ```