Venta de productos físicos: flujos de pago
En esta página
Lección reescrita el 3 de noviembre de 2026 basándose en la Referencia de la API de Checkout, la página Añadir interfaz de usuario a tu servidor MCP y las Directrices de plugins de OpenAI. La versión anterior cubría la venta de suscripciones y productos digitales mediante funciones inventadas (
defineProduct,commerceFlow) y una estructura de comisiones del 30 %/15 % sin fuentes. Las normas actuales de los plugins restringen el comercio exclusivamente a productos físicos, y la documentación no menciona comisiones. Fuentes: Referencia de la API de Checkout · Directrices de plugins.
Qué puedes vender
Empieza por la norma, ya que gobierna todo lo demás. Las reglas de publicación de OpenAI son claras: un plugin solo puede realizar transacciones comerciales de productos físicos. Queda prohibida la venta de productos digitales o servicios —suscripciones, contenidos digitales, tokens, créditos—, ya sea de forma directa o indirecta (por ejemplo, mediante una venta adicional freemium). También se aplica una lista de bienes y servicios prohibidos (contenido para adultos, juegos de azar, medicamentos con receta, armas, tabaco y nicotina, software pirateado, servicios financieros engañosos, entre otros). La lección 13 vuelve a examinar qué puede hacer un servicio de suscripción dentro de estos límites.
Dentro de este marco, OpenAI documenta tres flujos de pago.
Flujo 1: Pago externo, la ruta predeterminada
El pago externo es el enfoque recomendado y está disponible para todos. La interfaz de usuario del plugin presenta los productos elegibles, por ejemplo con un botón «Comprar». Cuando el usuario decide realizar la compra, la interfaz lo redirige a un túnel de pago alojado en tu propio dominio. La fijación de precios, la recaudación, los impuestos, los descuentos, el envío, las devoluciones, el soporte y el cumplimiento normativo siguen siendo enteramente tu responsabilidad. Tras la compra, el usuario puede volver a ChatGPT con su confirmación de pedido o el seguimiento de la entrega.
Para abrir este enlace, ChatGPT proporciona la extensión window.openai.openExternal({ href }), que abre un enlace controlado en el navegador del usuario. Debes declarar los destinos de redirección permitidos en _meta["openai/widgetCSP"].redirect_domains: la política estándar _meta.ui.csp no cubre este caso. Para un destino aprobado, ChatGPT añade por defecto un parámetro ?redirectUrl=… a la dirección; establecer redirectUrl: false impide esto.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// El host carece de esta extensión: permite al usuario copiar el enlace
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Las normas son específicas: mientras el pago integrado no esté abierto a tu plugin, el pago externo es la ruta obligatoria. No se puede integrar ni alojar ninguna otra solución de pago de terceros dentro de la interfaz de usuario del plugin.
Flujo 2: Métodos de pago guardados anteriormente
Para compras elegibles de productos físicos, la interfaz de usuario puede ofrecer al cliente un método de pago que ya haya guardado contigo. El usuario selecciona este método y confirma la compra dentro de ChatGPT, sin abandonar la conversación. Tu servidor MCP procesa el pedido y devuelve la confirmación vinculante. Este flujo puede mostrar métodos de pago guardados, pero no puede recopilar nuevos datos de pago.
Flujo 3: La hoja de pago de ChatGPT (beta privada)
Para recopilar un nuevo método de pago dentro del flujo, necesitas la hoja de pago de ChatGPT. Esta función de pago integrado se encuentra en beta privada, reservada para mercados específicos, y no es accesible para todos los desarrolladores o usuarios. Su funcionamiento merece la pena entenderlo porque ilustra la división de roles entre el anfitrión y tu servidor:
- Una herramienta MCP devuelve una sesión de pago en
structuredContent. - El componente muestra artículos, totales, condiciones y opciones de envío.
- Cuando el usuario elige pagar, el componente llama a
window.openai.requestCheckout(session); ChatGPT abre su hoja de pago. - Tras la validación, ChatGPT envía un token que representa el método de pago elegido a la herramienta
complete_checkoutde tu servidor. Esta herramienta realiza el cargo a través de tu proveedor de pagos y devuelve el pedido finalizado: el resultado que el componente recibe en respuesta arequestCheckout.
La sesión debe contener un identificador único, los artículos y sus cantidades, los totales en unidades monetarias menores (céntimos, no euros decimales), el proveedor de pagos y los metadatos del comerciante, así como enlaces obligatorios: condiciones, privacidad, devoluciones y soporte. ChatGPT añade sus propios campos, como merchant o conversation_id.
El servidor es la fuente de la verdad
Independientemente del flujo, se aplica la misma disciplina:
- Los precios y el estado del pedido provienen del servidor, nunca de un total calculado en el componente.
- El token de pago se verifica, la operación es idempotente —un doble clic no debe generar un doble cargo—, se registra el pedido y se devuelve un recibo de referencia.
- La cancelación, el rechazo del pago y los errores del proveedor se gestionan en el componente. Para la hoja de pago, los errores
payment_declinedyrequires_3dsdevueltos porcomplete_checkoutse muestran directamente en la hoja de ChatGPT.
Para la hoja de pago, payment_mode: "test" permite probar el flujo de extremo a extremo con tarjetas de prueba sin mover fondos reales.
Mantén disponibles las herramientas útiles sin interfaz de usuario
Al igual que con el resto del plugin, el catálogo y las capacidades de pedido deben seguir siendo accesibles mediante herramientas utilizables sin un componente. La interfaz de usuario sirve para presentar productos, precios, condiciones y opciones de pago antes de la confirmación. No sustituye a herramientas de datos robustas y nunca decide un precio.
Puntos clave
- Un plugin vende solo productos físicos: están prohibidas las suscripciones, los contenidos digitales, los créditos y las ventas adicionales freemium
- El pago externo en tu dominio es la ruta recomendada disponible para todos;
openExternalabre el enlace - Se pueden ofrecer métodos de pago guardados, pero no recopilarlos
- La hoja de pago de ChatGPT (
requestCheckout+complete_checkout) está en beta privada, reservada para mercados específicos - El servidor es la fuente de la verdad: cálculos de precios en el servidor, operaciones idempotentes, importes en unidades menores