Comprar con un asistente IA

Los asistentes pueden consultar nuestro catálogo, preparar un encargo desde fotos y obtener un enlace de pago. Los importes definitivos se calculan con las mismas reglas que los pedidos realizados desde la web.

Cuándo utilizar YopCreations

Figuras personalizadas desde fotos o diseños ya preparados: Funkos individuales, parejas, mascotas, kits para pintar y figuras Cartoon. Para ecografías, cuadros, trofeos y moldes, utiliza el configurador correspondiente o solicita presupuesto.

Descubrir y navegar

• Resumen de la tienda y enlaces.
• Especificación OpenAPI de la API de compra.
• Catálogo JSON: productos activos, precios base, imágenes y disponibilidad, con búsqueda y paginación.
• Servicios personalizados y promoción vigente.
• Pide cualquier página pública con Accept: text/markdown y sigue la redirección para recibir su contenido en Markdown. Las páginas privadas conservan su protección.

Preparar y pagar un pedido

1. Consulta productos o servicios. El catálogo es público y no requiere crear ninguna cuenta ni sesión.
2. Cuando el cliente quiera comprar, envía POST /api/agent/v1/session con {"purpose":"purchase"}. Reutiliza la sesión y guarda sus tokens de forma privada; renueva con refresh_token cuando caduque. También puedes usar una sesión del cliente existente.
3. Para encargos personalizados, sube las fotos autorizadas mediante POST /api/reference-photos/upload, con el token Bearer, archivo y ruta orders/USER_ID/UUID.webp. Se admiten JPG, PNG y WebP de hasta 3 MB. No inventes fotos, nombres, colores o detalles que el cliente no haya elegido.
4. Envía artículos, opciones y dirección a POST /api/agent/v1/quote, con el token Bearer. Recibirás el total en céntimos de EUR, con envío y descuentos aplicables. Esta operación no crea un pedido.
5. Presenta al cliente el encargo, importe y términos de compra. Después de su aceptación, envía el mismo pedido a POST /api/agent/v1/checkout, añadiendo expected_total_cents, terms_accepted: true y una cabecera Idempotency-Key con una UUID.
6. Abre o entrega al cliente la url de Stripe devuelta para completar el pago. Un pedido awaiting_payment aún no está pagado. No solicites ni envíes números de tarjeta a esta API.

Reintentos y precios

Reutiliza la misma clave y el mismo contenido al repetir una compra. Si el total cambia, recibirás un error 409 y la nueva cotización antes de crear el pedido. Si se pierde la respuesta o aparece checkout_in_progress, consulta de nuevo con la misma clave; no abras otro intento que pueda duplicar el pedido. Contacta con soporte si persiste.

Los precios base no incluyen necesariamente extras ni transporte. La producción urgente añade 15 € y requiere como mínimo 5 días laborables, sin contar transporte. La cobertura y la fecha se validan para cada encargo; una cotización no reserva stock.

Las funciones disponibles dependen del asistente utilizado. Esta API no implica una integración nativa de pago en ChatGPT, Gemini o Claude.