Building Agentic Commerce #3: cómo interpretar Trust Score v4.1
Trust Score v4.1: tres dimensiones ponderadas, un bonus opcional y topes de confianza. Consulta el motor de cada respuesta; puede recurrir a v2.
Resumen ejecutivo
Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.
Publicado
2026-04-06
Actualizado: 2026-09-13
6 min de lectura
Autoría
Trusteed
Publicado por Trusteed
Escrito y mantenido por quienes construyen Trusteed. Las afirmaciones técnicas de estos artículos se respaldan en las superficies enlazadas desde cada pieza y en el registro de capacidades firmado en /.well-known/trusteed-capabilities.json, que es el árbitro cuando un artículo y una superficie de estado se contradicen.
Sobre TrusteedCategoría
Guías para desarrolladores
Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.
Emitir un recibo no significa que se haya liquidado un pago. En la revisión del 2026-09-13, el registro público de comercios declaraba beta_closed, ningún comercio de producción y accepts_real_payments=false. Consulta /.well-known/merchant-index.json para conocer la disponibilidad actual; las demostraciones y vistas previas de checkout no acreditan compras reales.
Consulta el motor antes que el número
Consulta engines.overall y engines.breakdown antes de interpretar el número. overall usa 0–1; trust_score_v41 usa 0–100 cuando está disponible. Con engines.mixed=true, el desglose no explica overall. insufficient_data indica falta de evidencia utilizable, no un cero medido; la ruta pública puede devolver un resultado degradado de v2.
Un agente que consume scores de Trusteed puede usarlos como una señal de decisión. Otros agentes pueden usar reseñas, información visual u otras fuentes. Una puntuación no autoriza una compra, no sustituye el consentimiento ni garantiza la entrega.
Cómo se calcula v4.1
- 1merchantReliabilityBase: evidencia operativa sobre el comercio.
- 2agenticReadiness: preparación para atender a agentes.
- 3agenticEvidence: evidencia de operaciones con agentes.
- 4External Assurance: bonus opcional de hasta 10 puntos, sujeto a condiciones de evidencia. No es una cuarta dimensión ponderada.
Los pesos dependen de la confianza y se renormalizan entre las dimensiones aplicables. El bonus externo se aplica tras el score base y antes del tope del nivel. En el modelo base publicado, los topes son 65 para cold_start, 85 para human_established, 92 para agent_verified_thin y 100 para agent_verified. Consulta la metodología viva para los criterios y las extensiones habilitadas; el nombre de un nivel no es un certificado de identidad.
Falta de evidencia y fallback
Distingue verified, measured, proxy, self_declared, not_applicable y synthetic_blocked como calidades de evidencia diferentes. La ausencia de datos no debe presentarse como un cero medido. Si el overlay v4.1 está deshabilitado, falla o no produce un valor, la ruta pública puede servir v2. Un resultado degradado de v2 no es comparable con v4.1 como si exigieran la misma evidencia.
Consulta y verifica la respuesta API
GET https://api.trusteed.xyz/api/v1/stores/{slug}/trust-score devuelve el score público. Resuelve el comercio y su origen de datos desde /.well-known/merchant-index.json; no presupongas que la misma ruta en otro host lee la misma base de datos. Verifica la firma de la respuesta con el JWKS de confianza del emisor. Una firma válida autentica la respuesta, no la calidad de todos los datos de origen.
Observado el 2026-09-13 en demo-store, una tienda sandbox; es un ejemplo fechado, no su score actual: ```json { "overall": 0.447, "trust_score_v41": 44.7, "confidence_level": "cold_start", "engines": { "overall": "v4.1", "breakdown": "v2", "mixed": true } } ```
Ranking de búsqueda y políticas de checkout
La elegibilidad de búsqueda, el ranking y los controles de checkout son decisiones separadas. Consulta el contrato del endpoint y la configuración del comercio. El score público puede proceder de un motor distinto al valor almacenado que usa la búsqueda. Etiquetas como VERIFIED son bandas de puntuación, no pruebas de identidad ni permiso para omitir la confirmación.
La confianza del comercio y del agente son distintas
El Trust Score del comercio describe al comercio. La confianza del agente comprador y vendedor corresponde a otros actores y a sus controles. No uses el score del comercio como autorización del agente ni copies umbrales entre esas políticas.
Legacy v2: desglose por componentes
El modelo legacy v2 es una suma ponderada en escala 0–1, programada cada 6 horas. Sus componentes pueden aparecer junto a una puntuación global v4.1 cuando engines.mixed=true. Usa este desglose para explicar un número solo si engines.overall identifica v2. El endpoint de metodología publica los pesos y marca este alcance como legacy_v2.
- 1Señales de catálogo: lo completos, lo frescos y lo exactos que son los datos del comercio en precio y disponibilidad.
- 2Señales operativas: qué cubren las políticas publicadas del comercio, y cómo han ido de verdad sus checkouts, sus entregas y sus disputas.
- 3Señales de posventa y coherencia, añadidas en v2 sobre las ocho originales.
- 4Este artículo nombra los grupos, no los campos. GET /api/v1/trust/methodology devuelve cada componente con su peso y etiqueta este ámbito como legacy_v2: esa lista es la que no puede quedarse vieja, y una copia en un artículo es la primera que se queda.
Comprobaciones para integrar el score
- 1Consulta juntos el host del comercio, engines, escalas, confianza y fecha.
- 2Si la respuesta es mixta, no reconstruyas el score v4.1 con componentes v2.
- 3Trata la evidencia ausente y el fallback v2 de forma explícita en tu política.
- 4Consulta las reglas y la autorización por separado del score.
- 5Comprueba la disponibilidad de pagos reales antes de tratar una vista previa o demo como una compra.
Preguntas frecuentes
¿Cómo se calcula el Trust Score actual?
Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.
¿Por qué la API muestra 0–1 y 0–100?
Consulta engines.overall y engines.breakdown antes de interpretar el número. overall usa 0–1; trust_score_v41 usa 0–100 cuando está disponible. Con engines.mixed=true, el desglose no explica overall. insufficient_data indica falta de evidencia utilizable, no un cero medido; la ruta pública puede devolver un resultado degradado de v2.
¿Cada cuánto se recalcula?
El job legacy v2 está programado cada 6 horas. El overlay público v4.1 puede ejecutarse por petición. Consulta juntos motor y fecha, sobre todo en respuestas mixtas.
¿Un score alto autoriza un pago?
No. La autorización, las reglas del comercio y la disponibilidad de pagos requieren comprobaciones separadas. Un score no garantiza liquidación ni entrega.
Fuentes y referencias
- Trust Score methodology
Trusteed
- Trust Score guide
Trusteed
- Public merchant registry
Trusteed
Artículos relacionados
Guías para desarrolladores
Building Agentic Commerce #1: checkout multiprotocolo con MCP + x402 + ACP en un solo flujo
Un agente, tres protocolos, un checkout. Asi es como MCP, pagos stablecoin x402 y ACP trabajan juntos para que los agentes de IA compren productos, con ejemplos de código que puedes ejecutar hoy.
Guías para desarrolladores
Building Agentic Commerce #2: Como los agentes de IA descubren tu tienda sin API Key
Antes de que un agente pueda comprar algo, necesita encontrar tu tienda. Así funciona la cadena de descubrimiento de 6 fases que lleva a un agente de IA de cero conocimiento a listo para checkout en menos de 2 segundos, sin configuración previa.
Comercio Agéntico
Comercio agéntico: guía práctica para equipos ecommerce
Una guía clara y orientada a negocio para entender qué cambia en descubrimiento, confianza, checkout y operaciones cuando los agentes de IA empiezan a influir en la compra.